为 何 写作 本 书 


几 年 前 我 作为 一 名 财 入 式 工 程 师 参与 了 一 个 关于 低 功 耗 车 载 终端 的 研发 项 目 ， 该 低 功 耗 车 载 终端 中 包含 一 个 GPs 模 块 和 一 个 GPRS (2G) 模块 ， 工 程 师 们 希望 通过 最 少 的 能 量 消耗 把 终端 的 GPS 坐标 上 
传 至 Web 服 务 器 中 。 虽 然 需求 直截了当 ， 但 是 在 开发 的 过 程 中 却 出 现 了 各 种 各 样 的 分 歧 。 例 如 传输 协议 采用 UDP 还 是 TCP， 有 的 工程 师 认 为 UDP 没有 连接 过 程 ， 传 输 时 间 更 短 ， 有 的 工程 师 认为 TCP 更 加 可 
靠 而 UDP 也 许 会 出 现 “ 丢 包 ” 现 象 。 经 过 多 次 争论 最 终 选 择 了 UDP 传输 加 自 定义 重 传 的 方式 。 所 谓 自 定 义 重 传 ， 就 是 车 载 终端 把 相同 的 数据 包 按照 一 定 的 时 间 间 隔 连 续 传 输 三 次 ， 每 个 数据 包 都 包含 一 个 递 
增 的 子 序号 ， 服 务 器 通过 子 序号 来 剔除 重复 内 容 。 通 过 增加 这 种 容错 机 制 似乎 解决 了 UDP 的 “缺陷 ”， 但 是 由 于 终端 设备 采用 单 向 传输 方式 ， 并 不 要 求 服务 器 返回 响应 ， 所 以 终端 根本 不 知道 它 上传 的 数据 
是 否 被 正确 处 理 。 


在 项 目 开发 的 过 程 中 ， 工 程 师 们 在 终端 设备 与 Web 平 台 的 衔接 方式 的 选择 上 也 出 现 了 不 少 分 上 层 。 在 定制 应 用 层 协 议 时 嵌入 式 工程 师 更 喜欢 二 进 制 协 议 , 但 对 于 Web 开 发 工程 师 来 说 /SON 和 XML 才 是 他 
们 所 擅长 的 内 容 。 因 此 ，Web 开 发 工程 师 单独 做 了 一 个 UDP 套 接 字 服 务 ， 使 终端 设备 可 以 把 二 进 制 内 容 转 化 为 JJON 格 式 的 数据 包 ， 再 把 这 个 JsSON 数 据 包 “POST” 到 一 个 HTTP 服 务 器 。 此 时 对 于 Web 开 
发 工程 师 来 说 ， 设 备 其 实 是 在 提交 表单 。 


经 过 工程 师 们 的 不 断 努 力 ， 这 个 低 功 耗 车 载 终端 如 期 完成 。 但 是 项 目 完成 之 后 我 不 禁 思 考 : 这 个 项 目 是 不 是 可 以 做 得 更 好 一 点 ， 是 不 是 可 以 打破 嵌入 式 工程 师 和 Web 开 发 工程 师 的 技术 鸿沟 ， 是 不 是 有 
更 好 的 应 用 协议 可 以 满足 项 目 需求 ， 是 不 是 低 功 耗 终端 也 可 以 提交 表单 ”查阅 了 众多 资料 之 后 ， 我 找到 了 CoAP。 


回想 硕士 毕业 之 后 我 “执着 ”地 成 为 一 名 专注 于 物 联网 的 软件 工程 师 ， 而 我 本 科 和 硕士 的 专业 都 与 机 械 工程 相关 。 与 其 他 计算 机 或 电子 专业 不 同 ， 机 械 工程 特别 强调 规范 和 标准 ， 所 以 设计 过 程 必须 严 
格 遵 守 规范 。 虽 然 表 面 上 这 显得 异常 死板 ， 但 是 这 种 规范 却 大 大 提高 了 系统 的 互 换 性 ,节约 了 开发 成 本 。 在 这 种 理念 的 指导 下 ， 我 总 是 先 寻 找 标准 解决 方案 而 不 是 随时 随地 准备 “ 造 轮 子 ”。CoAP 是 一 个 由 
IETF (Internet Engineering Task Force， 互 联网 工程 任务 组 ) 组 织 编写 的 面向 低 功 耗 设备 的 物 联网 应 用 层 协 议 ， 协 议 编号 为 RFC 7252。 我 非常 高 兴 找 到 了 应 用 “标准 ”， 而 不 是 又 找到 了 一 组 “轮子 ”。 


CoAP 有 很 多 优点 ， 而 这 些 优点 正好 可 以 解决 上 文 提 到 的 低 功 耗 车 载 终端 所 遇 到 的 问题 : 

1) CoAP 传 输 层 协议 采用 UDP， 对 于 终端 来 说 UDP 的 确 可 以 减少 一 部 分 能 耗 。 

2) CoAP 采 用 请 求 /响应 工作 模式 ， 当 终端 设备 发 送 CoAP 请 求 之 后 ， 服 务 器 将 返回 响应 码 ， 终 端 通过 响应 码 可 以 判断 服务 器 的 处 理 结果 。 

3) COoAP 包 含 重 传 机 制 ， 不 用 再 重新 设计 重 传 方法 。 

4) CoAP 参 考 了 HTTP 的 大 量 成 功 经 验 ， 如 CoAP 请 求 方法 、CoAP 选 项 定义 和 CoAP 响 应 码 等 ， 所 以 Web 开 发 工程 师 也 可 以 非常 容易 地 掌握 CoAP。 


CoAP 可 以 帮助 低 功 耗 智能 终端 接 入 网 络 ， 通 过 这 种 标准 协议 也 可 以 降低 物 联网 系统 的 开发 难度 ， 尤 其 可 降低 物 联 网 Web 平 台 的 开发 难度 。 对 于 应 用 CoAP 的 终端 设备 来 说 ， 同 样 会 遵守 REST 标 准 ， 使 
用 类 似 的 资源 描述 方法 ， 使 用 相同 的 请 求 方法 ， 应 用 相同 的 JSON 数 据 包 。 对 于 物 联 网 Web 平 台 来 说， 处 理 一 次 终端 设备 的 数据 上 传 和 处 理 一 次 Ajax 表单 提交 同样 容易 。 


我 个 人 喜欢 阅读 技术 图 书 ， 通 过 阅读 图 书 可 以 系统 地 掌握 一 门 新 技术 ， 我 也 希望 本 书 可 以 帮助 读者 熟练 掌握 CoAP， 并 把 它 应 用 于 物 联 网 系统 中 。 
目标 读者 


本 书 适合 物 联网 爱好 者 、 嵌 入 式 工 程 师 和 Web 开 发 工程 师 。 


. 对 于 物 联网 爱好 者 而 言 ， 本 书 的 示例 可 以 让 你 更 快 地 熟悉 物 联 网 系统 。 本 书包 括 很 多 与 物 联网 系统 相关 的 基础 知识 ， 通 过 这 些 基础 知识 的 学 习 可 以 加 深 你 对 物 联 网 系统 的 理解 。 通 过 本 书 中 的 多 个 动 
手 示例 ， 你 可 以 掌握 物 联 网 系统 的 调试 方法 。 


“ 对 于 府 入 式 工 程 师 而 言 ， 本 书 可 以 帮助 你 从 不 同 角度 了 解 低 功 耗 设 备 如 何 连 接 网 络 。 通 过 CoAP 的 学 习 可 以 从 另 一 个 角度 熟悉 HTTP。CoAP 和 HTTP 都 是 设备 连接 网 络 的 常见 手段 。 


. 对 于 Web 开 发 工程 师 而 言 ， 可 以 从 另 一 个 角度 了 解 设 备 如何 提 交 “ 表 单 ”， 通 过 学 习 CoAP 你 会 发 现 低 功 耗 终端 设备 也 可 以 很 流畅 地 接 入 系统 ， 而 不 需要 做 多 余 的 协议 转换 。 
如 何 阅读 本 书 
本 书 的 主要 内 容 大 致 分 为 三 部 分 : 


第 一 部 分 : 第 1 ~ 3 章 。 第 1 章 介绍 与 物 联网 应 用 直接 相关 的 各 种 协议 ， 这 些 协议 包括 IP、6LoWPAN 协 议 、IEEE 802.15.4 协 议 、HTTP、MQTT 协 议和 CoAP 等 ; 第 2 章 介绍 与 物 联 网 应 用 相关 的 开源 硬件 
Arduino 和 树 莓 派 ， 无 论 是 Arduino 还 是 树 莓 派 都 是 开源 硬件 领域 的 “明星 产品 ”， 在 这 些 硬件 平台 上 可 以 快速 实现 CoAP; 第 3 章 与 前 面 两 章 不 同 ， 该 章 通 过 多 个 示例 详细 介绍 与 CoAP 息 息 相关 的 网 络 协议 
一 一 IP、UDP、TCP 和 HTTP， 掌 握 这 些 协 议 是 学 习 CoAP 的 基础 。 


第 二 部 分 : 第 4~ 8 章 。 在 第 4 章 中 先 通 过 一 个 简洁 示例 让 读者 对 CoAP 有 一 个 大 致 的 了 解 ， 该 示例 包含 CoAP 客 户 端 和 CoAP 服 务 器 两 个 部 分 ，CoAP 服 务 器 使 用 Arduino UNO 实 现 ， 通 过 一 个 安装 了 
Copper 插 件 的 Firefox 浏 览 器 便 可 访问 该 CoAP 服 务 器 ; 第 5 章 与 第 6 章 详细 分 析 与 CoAP 相 关 的 RFC 文 档 ， 这 两 章 是 掌握 CoAP 的 理论 基础 ;第 7 章 介 绍 多 种 CoAP 客 户 端 和 服务 器 的 实现 方法 ， 这 些 实现 方法 
包括 C 语 言 、Python、Node.js 和 Java; 在 实际 项 目 中 使 用 CoAP 难 免 出 现 问题 ， 第 8 章 介 绍 CoAP 的 多 种 调试 方法 ， 通 过 Copper 插 件 和 Wireshark 网 络 抓 包工 具 可 以 快速 地 发 现 CoAP 的 细节 错误 。 


第 三 部 分 : 9.10 章 。 最 后 两 章 设计 一 个 微型 的 物 联网 系统 ， 试 图 通过 该 系统 向 读者 展现 物 联网 系统 从 设计 a 到 实现 的 整个 过 程 。 微 型 物 联 网 系统 包括 服务 器 和 设备 两 部 分 。 服 务 器 部 分 (第 9 章 ) 包括 
Web 前 端 、 后 端 和 数据 库 部 分 的 实现 内 容 ， 与 其 他 Web 系 统 不 同 ， 该 系统 还 包括 CoAP 服 务 器 实现 ;设备 部 分 (第 10 章 ) 使 用 一 个 低 功 耗 受 限制 设备 作为 CoAP 客 户 端 ， 该 设备 使 用 Contiki 作 为 嵌入 式 操 作 
系统 ， 使 用 IEEE 802.15.4 这 样 的 无 线 方式 连接 网 络 。 


相关 资料 
本 书 提供 多 个 基础 示例 ， 这 些 示 例 代码 可 以 帮助 读者 深入 了 解 CoAP。 
示例 代码 仓库 : https:;//github.com/xukai871105/the beginning of coap。 
本 书 还 提供 一 个 CoAP 测 试 服务 器 ， 该 测试 服务 器 部 署 于 阿里 云 ， 国 内 用 户 可 以 非常 方便 地 访问 该 服务 器 。 
CoAP 测 试 服务 器 : coap: //wsncoap.org. 
勘误 和 支持 


由 于 时 间 和 水 平方 面 的 限制 ， 书 中 难免 出 现 错误 或 者 描述 不 准确 的 地 方 ， 尾 请 读者 批评 指正 。 如 果 读 者 在 阅读 过 程 中 发 现 问题 ， 可 通过 个 人 博客 或 邮箱 与 我 取得 联系 。 


我 的 邮箱 : xukailO871105(»126.com, 


我 的 博客 : http://blog.csdn.net/xukai871105。 
致谢 


感谢 机 械 工 业 出 版 社 华章 公司 的 编辑 ， 没 有 你 们 的 鼓励 就 不 会 有 这 本 书 。 感 澳 我 的 同事 岭 红 鹏 、 王 次 庭 、 许 静 和 伊 明 ， 感 谢 你 们 与 我 一 同 讨论 CoAP 的 各 种 细节 问题 ， 并 把 CoAP 真 正 应 用 到 实际 产品 
中 。 最 后 感谢 我 的 妻子 左 文 娟 ， 在 这 一 年 多 的 时 间 里 始终 支持 我 的 写作 ， 是 你 的 鼓励 让 我 最 终 完 成 本 书 。 


第 1 章 ” 物 联网 与 网 络 协议 


11 本 章 主要 内 容 


COAP 是 受 限制 应 用 协议 (Constrained Application Protocol) 的 简称 ，CoAP 是 物 联 网 应 用 层 协议 之 一 。 当 前 市 面 上 有 很 多 物 联 网 应 用 层 协 议 ， 它 们 之 间 既 相互 关联 也 存在 明显 区 别 。 本 章 将 重点 介 
绍 三 种 物 联网 应 用 层 协议 一 CoAP、HTTP 和 MGQTT， 三 种 协议 具有 各 自 不 同 的 适用 场景 ， 在 物 联 网 领域 均 有 广泛 的 应 用 。 


HTTP 和 MQTT 使 用 TCP 作 为 传输 层 协议 ， 而 CoAP 则 使 用 UDP 作 为 传输 层 协议 。 无 论 是 UDP 还 是 TCP 均 依赖 于 IP 技 术 ，IP 技 术 是 现代 网 络 通 信 的 基础 。IP 又 分 为 IPv4 和 0IPv6 两 个 版 本 ，1Pv4 已 经 广 为 人 
知 而 IPv6 才 网 网 投入 使 用 。 随 着 智能 设备 的 发 展 ， 越 来 越 多 的 设备 需要 接 入 网 络 ，IPv4 地 址 枯竭 的 问题 越 来 越 严重 。6LoWPAN 技 术 是 一 种 IPv6 头 压缩 技术 ， 通 过 6LoWPAN 头 压缩 技术 可 以 有 效 地 解决 智能 
设备 通过 IPv6 接 入 网 络 的 问题 。 图 1-1 可 以 很 好 地 概括 本 章 的 具体 内 容 。 


| WHJ 
传输 层 


网 络 层 


图 1-1 物 联网 协议 概述 
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11 本 章 主要 内 容 


CoAP 是 受 限 制 应 用 协议 (Constrained Application Protocol) 的 简称 ，CoAP 是 物 联 网 应 用 层 协议 之 一 。 当 前 市 面 上 有 很 多 物 联 网 应 用 层 协议 ， 它 们 之 间 既 相互 关联 也 存在 明显 区 别 。 本 章 将 重点 介 
绍 三 种 物 联 网 应 用 层 协 议 一 一 CoAP、HTTP 和 MQTT， 三 种 协议 具有 各 自 不 同 的 适用 场景 ， 在 物 联网 领域 均 有 广泛 的 应 用 。 


HTTP 和 MQTT 使 用 TCP 作 为 传输 层 协议 ， 而 CoAP 则 使 用 UDP 作 为 传输 层 协议 。 无 论 是 UDP 还 是 TCP 均 依赖 于 IP 技 术 ，IP 技 术 是 现代 网 络 通 信 的 基础 。IP 又 分 为 IPv4 和 IPv6 两 个 版 本 ，1Pv4 已 经 广 为 人 
知 而 IPv6 才 网 网 投入 使 用 。 随 着 智能 设备 的 发 展 ， 越 来 越 多 的 设备 需要 接 入 网 络 ，IPv4 地 址 枯竭 的 问题 越 来 越 严重 。6LoWPAN 技 术 是 一 种 IPv6 头 压缩 技术 ， 通 过 6LoWPAN 头 压缩 技术 可 以 有 效 地 解决 智能 
设备 通过 |Pv6 接 入 网 络 的 问题 。 图 1-1 可 以 很 好 地 概括 本 章 的 具体 内 容 。 


图 1-1 物 联网 协议 概述 


1.2 物 联网 与 IP 


毫 无 疑问 IP 技 术 是 当今 互联 网 应 用 的 基础 ， 同 时 IP 技 术 也 是 物 联 网 应 用 的 基础 。 本 章 中 IP 技 术 分 为 IPv4、1IPv6 和 6LoWPAN 三 个 部 分 进行 介绍 。 


1.2.1 IPv4 


1Pv4 即 互联 网 协议 版 本 4， 又 称 互 联网 通信 协议 第 4 版 。1PVv4 为 标准 化 互联 网 络 的 核心 部 分 ， 也 是 使 用 最 广泛 的 互联 网 协议 版 本 ， 其 后 继 版 本 为 jPv6， 直 到 2011 年 IANA IPv4 pool 地 址 已 经 完全 用 尽 
时 ，1Pv6 仍 处 在 部 署 的 初期 。1Pv4 是 一 种 无 连接 的 协议 ， 此 协议 会 尽 最 大 努力 交付 分 组 数据 ，1Pv4 不 保证 任何 分 组 数据 均 能 送 达 目 的 地 ， 也 不 保证 所 有 分 组 数据 均 按 照 正 确 的 顺序 无 重复 地 到 达 。 


IPv4 使 用 32 位 (4 字 节 ) 地 址 ， 因 此 地 址 空间 中 只 有 4294967296 个 地 址 。 不 过 ， 一 些 地 址 为 特殊 用 途 所 保留 ， 如 专用 网 络 ( 约 1800 万 个 地 址 ) 和 多 播 地 址 ( 约 2.7 亿 个 地 址 ) ， 专 用 网 络 和 多 播 地 址 也 
减少 了 可 人 在 互联 网 上 路 由 的 地 址 数量 。 随 着 地 址 不 断 被 分 配给 最 终 用 户 ，1Pv4 地 址 枯竭 问题 也 随 之 产生 。 基 于 NAT (网 络 地 址 转换 ) 等 地 址 结构 重 构 的 技术 显著 地 降低 了 IPv4 地 址 枯竭 的 速度 。 


毫 无 疑问 IPv4 技 术 是 物 联网 应 用 的 基础 。 关 于 终端 设备 ， 具 有 网 络 连 接 能 力 的 设备 很 有 可 能 包含 IPv4 协 议 栈 ， 这 就 意味 着 该 设备 可 以 很 容易 地 访问 网 络 中 的 任意 一 个 IPv4 应 用 ; 关于 网 关 设 备 ， 对 于 那 
些 尚 没有 网 络 连 接 能 力 的 设备 来 说 ， 也 可 以 通过 定制 的 网 关 设 备 转 发 有 用 内 容 ， 这 些 定制 的 网 关 设 备 往往 把 非 1P 数 据 包 转 换 成 IP 数 据 包 ; 关于 服务 器 ， 绝 大 多 数 Web 应 用 、 数 据 库存 储 应 用 和 搜索 服务 器 均 
依赖 于 IPv4 技 术 。 对 于 终端 设备 、 网 关 设 备 和 服务 器 而 言 ， 当 前 IPv4 技 术 支 撑 着 整个 物 联网 应 用 。 


但 是 IPv4 技 术 也 不 是 万 能 的 ， 随 着 物 联网 终端 设备 的 爆发 ，IPv4 地 址 枯竭 的 问题 显得 越 来 越 严重 ， 已 经 被 长 期 依赖 的 IPv4 技 术 并 不 一 定 是 物 联网 应 用 未 来 发 展 的 方向 。 


1.2.2 IPv6 


1Pv6 即 互联 网 通信 协议 第 6 版 ， 是 互联 网 协议 的 最 新 版 本 ， 旨 在 解决 |Pv4 地 址 枯竭 问题 。 在 因特网 中 ， 数 据 以 分 组 的 形式 传输 。1Pv6 定 义 了 一 种 全 新 的 分 组 格式 ， 目 的 是 为 了 最 小 化 路 由 器 处 理 的 报 文 首 
部 。 由 于 1IPv4 报 文 和 IPv6 报 文 首部 存在 很 大 不 同 ， 因 此 这 两 种 协议 无 法 互 操作 。1Pv6 具 有 比 1Pv4 大 得 多 的 编码 地 址 空间 ，1Pv6 采 用 了 128 位 的 地 址 ， 而 IPv4 使 用 的 是 32 位 。 因 此 新 增 的 地 址 空间 支持 
2128 ( 约 3.4x1038) 个 地 址 。 从 IPv4 到 IPv6 最 显著 的 变化 就 是 网 络 地 址 的 长 度 ，RFC 2373[1] 和 RFC 2374[2] 定 义 的 IPv6 地 址 有 128 位 长 ，IPv6 地 址 的 表达 形式 一 般 采 用 32 个 十 六 进 制 数 。 如 图 1-2 为 IPv6 
Ready 认 证 标签 。 


图 1-2 IPv6 Ready 认 证 标签 


1Pv6 技 术 据 除了 IPv4 技 术 的 多 数 局 限 ， 是 一 种 更 加 进步 与 优化 的 互联 网 协议 ， 它 具有 以 下 优势 : 

1) 强大 的 地 址 空间 : 正如 上 文 所 述 IPv6 的 地 址 长 度 为 128 位 ， 而 IPv4 的 地 址 长 度 仅 为 32 位 ， 强 大 的 地 址 空间 可 以 满足 物 联网 终端 设备 数量 增长 的 需求 。 
2) 即 插 即 用 : 1Pv6 采 用 即 插 即 用 的 机 制 实现 与 各 种 设备 的 网 络 连接 ， 相 关 配 置 可 以 自动 生成 而 并 不 需要 向 服务 器 申请 。 

3) 更 高 的 安全 性 : IPv6 特 性 描述 中 要 求 通 过 加 密 有 效 载 荷 和 通信 源 认证 等 方式 增强 网 络 的 安全 性 。 

4) 更 加 灵活 与 完善 的 首部 : IPv6 中 移 除 了 IPv4 中 并 不 常用 的 字段 ， 如 分 段 与 校 验 和 等 ， 采 用 了 固定 头 加 可 选 扩展 头 的 组 合 方式 。 


[1] https://datatracker.ietf.org/ doc/rfc2373/。 
[2] https:/ /datatracker.ietf.org/doc/tfc2374/ 。 


1.2.3 6LoWPAN 
虽然 IPv6 协 议 是 更 为 高 效 和 完善 的 互联 网 协议 ， 但 是 对 于 大 多 数 受 限制 的 物 联网 设备 来 说 ，IPv6 协 议 依然 元 余 而 复杂 。 为 了 让 IPv6 技 术 能 够 适用 于 低 功 耗 受 限制 物 联网 设备 ，6LoOWPAN 技 术 应 运 而 
Æ, 


IETF 组 织 于 2004 年 11 月 正式 成 立 了 6LoWPAN 工 作 组 ， 着 手 制定 基于 IPv6 的 低速 率 无 线 个 域 网 标准 ， 即 IPv6 over IEEE 802.15.4， 该 工作 组 将 IPv6 引 入 以 IEEE 802.15.4 为 标准 的 无 线 个 域 网 中 。1EEE 
802.15.4 是 无 线 个 域 网 技术 的 典型 代表 ， 已 经 获得 了 广泛 的 应 用 。 但 |EEE 802.15.4 标 准 只 规定 了 物理 层 和 媒体 访问 控制 层 两 部 分 ， 并 没有 涉及 网 络 层 以 上 规范 。 


图 1-3 可 以 很 好 地 说 明 6LoWPAN 与 |Pv6、IEEE 802.15.4 之 间 的 天 系 。 图 1-3 的 左 侧 部 分 说 明了 那些 非 受 限 制 设备 如 何 与 互联 网 建立 连接 ， 大 多 数 Linux 主 机 都 属于 非 爱 限制 设备 ， 这 些 设备 往往 具备 足够 
内 存 空间 和 很 好 的 运算 能 力 ， 如 市 面 上 常见 的 树 莓 派 。 对 于 树 莓 派 这 样 的 非 受 限 制 设 备 ， 可 以 使 用 IPv4 层 作为 网 络 层 协议 ， 使 用 IEEE 802.3 作 为 物理 层 和 链 路 层 协 议 。 而 对 于 那些 具有 IEEE 802.15.4 无 线 连 
接 能 力 的 受 限制 低 功 耗 设 备 来 说， 并 不 能 直接 使 用 IPv4 协 议 ， 而 需要 使 用 Pv6 加 6LoWPAN 方 式 ， 把 IPv6 首 部 经 过 6LoWPAN 技 术 压 缩 之 后 再 填充 到 IEEE 802.15.4 协 议 中 的 有 效 载 答 部 分 。 


1.IEEE 802.15.4 简 介 


IEEE 802.15.4 标 准 定义 了 物理 层 (PHY 层 ) 和 数据 链 路 层 (MAC 层 ) 。 市 面 上 有 不 少 符合 IEEE 802.15.4 标 准 的 SoC， 这 些 SoC 虽 然 资源 (内 部 RAM 和 Flash) 受 限 ， 功 能 较 低 ， 但 是 成 本 低廉 。 
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6LoWPAN 


IEEE 802.3 IEEE 802.15.4 物理 层 /数据 链 路 层 


有 线 方式 无 线 方式 
图 1-3 ”6LoWPAN 适 配 层 作用 
IEEE 802.15.4 标 准 的 主要 特征 如 下 : 
1) 低速 率 : 在 2.4GHz 频 段 最 大 速度 为 250Kbit/s。 
2) 地 址 短 : 支持 16 位 短 地 址 。 
3) 低 功 耗 : 可 支持 电池 供电 应 用 。 
4) 低 成 本 : 可 适用 于 资源 受 限 制 设备 。 


5) 短 距离 : 节点 信号 覆盖 范围 一 般 为 10 ~ 100 米 ， 覆 盖 范 围 有 限 。 


6) 低 复杂 度 : 相 比 于 IEEE 802.11 和 IEEE 802.15.1, IEEE 802.15.4 相 对 简单 ， 容 易 实 现 。 

7) 短 帧 长 : IEEE 802.15.4 数 据 链 路 层 的 最 大 传输 单元 为 127 字 节 ， 只 能 为 输出 的 数据 提供 较 少 的 有 效 空间 。 

8) 多 种 拓扑 结构 : IEEE 802.15.4 标 准 支持 点 对 点 和 星 形 网 络 。 

2.6LoWPAN 简 介 

因为 IPv6 要 求 数据 链 路 层 支 持 的 最 小 传输 单元 为 1280 字 节 ， 而 IEEE 802.15.4 链 路 的 最 大 传输 单元 仅 为 127 字 节 ， 所 以 需要 在 网 络 层 之 下 定义 一 个 适 配 层 ， 负 责 I1P 数 据 包 的 压缩 、 分 片 和 重组 等 工作 。 


6LoWPAN 适 配 层 之 下 采用 |EEE 802.15.4 规 定 的 物理 层 和 数据 链 路 层 ，6LoWPAN 适 配 层 之 上 的 网 络 层 采 用 IPv6 协 议 。 由 于 在 IPv6 中 数据 链 路 层 支 持 的 载荷 长 度 远 大 于 IEEE 802.15.4 所 能 提供 的 最 大 载 
WKE, 7g SiWIEEE 802.15.4 与 网 络 层 (IPv6) 的 无 颖 链接 ，6LoWPAN 适 配 层 被 增加 至 网 络 层 和 IEEE 802.15.4 之 间 ，6LoWPAN 适 配 层 用 来 完成 头 压缩 、 分 片 与 重组 以 及 网 状 路 由 转发 等 工作 。 


6LoWPAN 技 术 具 有 如 下 优势 : 

1) 普及 性 : IP 应 用 非常 广泛 ， 作 为 下 一 代 互 联网 核心 技术 的 IPv6 也 在 加 速 其 普及 的 步伐 。 

2) 适用 性 :IP 网络 协 议 栈 架构 受到 广泛 的 认可 ， 低 速率 无 线 个 域 网 完全 可 以 基于 此 架构 进行 简单 、 有 效 的 开发 。 

3) 更 多 地 址 空间 : 1Pv6 应 用 于 低 功 耗 无 线 个 域 网 的 最 大 亮点 就 是 庞大 的 地 址 空间 。 这 恰恰 满足 了 部 署 大 规模 、 高 密度 设备 的 需要 。 

4) 支持 无 状态 自动 地 址 配置 : IPv6 中 当 节 点 启动 时 ， 可 以 自动 读 取 MAC 地 址 ， 并 根据 相关 规则 配置 好 所 需 的 IPv6 地 址 。 

5) 易 接 入 : 低速 率 无 线 个 域 网 使 用 IPv6 技 术 ， 更 易于 接 入 其 他 基于 1P 技 术 的 网 络 及 下 一 代 互 联网 ， 使 其 可 以 充分 利用 IP 网 络 的 技术 进行 快速 发 展 。 


图 1-4 可 以 很 好 地 说 明 6LoWPAN 头 压缩 技术 如 何 与 IEEE 802.15.4 标 准 配合 工 作 。1IEEE 802.15.4 标 准 的 物理 层 部 分 一 般 包 括 先导 码 、 同 步 字 和 物理 层 长 度 指 示 域 和 物理 层 有 效 载荷 等 部 分 ; 在 数据 链 路 
层 部 分 又 可 分 为 帧 控制 域 、 序 列 号 域 、 地 址 域 、 数 据 链 路 层 有 效 数 据 载 荷 与 校 验 区 域 等 部 分 ; 在 数据 链 路 层 有 效 载荷 部 分 又 可 分 为 IPv6 压 缩 头 部 分 和 IPv6 有 效 负 载 部 分 。 
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图 1-4 6LoWPAN 头 压缩 技术 与 IEEE 802.15.4 之 间 的 关系 


1.3 物 联 网 与 HTTP 


在 互联 网 领域 HTTP 是 应 用 最 为 广泛 的 应 用 层 协 议 ， 在 物 联网 领域 HTTP 也 是 不 可 或 缺 的 重要 组 成 部 分 。HTTP 的 成 功 应 用 也 影响 了 物 联 网 领域 的 专用 协议 ， 如 本 书 讨论 的 CoAP 借 鉴 了 HTTP 在 应 用 过 程 中 
大 量 的 成 功 经 验 。 熟 练 掌握 HTTP 对 物 联网 领域 的 专项 内 容 学 习 绝对 大 有 帮助 。 


1.3.1 HTTP 


HTTP ( 超 文本 传输 协议 ) 是 互联 网 上 应 用 最 为 广泛 的 一 种 网 络 协议 。 设 计 HTTP 最 初 的 目的 是 为 了 提供 一 种 发 布 和 接收 HTML 页 面 的 方法 。 通 过 HTTP 或 HTTPS 请 求 的 资源 由 统一 资源 标识 符 (Uniform 


Resource Identifier, URI) 来 标识 。 


HTTP 采 用 客户 端 请 求 -服务 器 响应 这 样 的 工作 模式 。 图 1-5 可 以 很 好 地 描述 这 种 请 求 /响应 工作 模式 。 通 常客 户 端 使 用 网 页 浏览 器 向 服务 器 上 指定 端口 (HTTP 的 默认 端口 为 80) 发 起 一 个 HTTP 请 求 。 服 
务 器 上 存储 着 很 多 资源 ， 如 普通 文本 、HTML 文 本 、 图 片 或 视频 文件 等 。 我 们 称 这 个 应 答 服务 器 为 源 服务 器 。 在 用 户 代理 和 源 服 务 器 中 间 可 能 存在 多 个 “中 间 层 ”， 比 如 代理 服务 器 、 网 关 或 隧道 等 。HTTP 
采用 TCP 作 为 其 传输 层 协 议 。 通 常 ， 由 客户 端 发 起 一 个 HTTP 请 求 ， 创 建 一 个 到 服务 器 指定 端口 的 TCP 连 接 。HTTP 服 务 器 则 在 那个 端口 监听 客户 端的 请 求 ， 一 旦 收 到 请 求 ， 服 务 器 将 会 向 客户 端 返回 状态 ， 
如 “HTTP/1.1200 OK”， 以 及 具体 的 响应 内 容 ， 如 文本 文件 、HTML 文 件 、 图 片 和 视频 文件 等 。 


WWW.Wsncoap.org 


/4772:::9--N | GET /index.html HTTP/1.1 


| Host: www.wsncoap.org 
! Accept: * HTTP 请 求 


f * ff 


HTTP/1.1 200 OK 
Content-Type: text/html 
HTTP 响 应 Content-Length: 617 


啊 应 实体 内 容 


图 1-5 HTTP 请 求 /响应 工作 模式 


1.3.2 ” REST 风格 


REST (具象 状态 传输 ) 是 Roy Thomas Fielding 博 士 于 2000 年 在 他 的 博士 论文 “Arch-itectural Styles and the Design of Network-based Software Architectures” 中 提出 来 的 一 种 Web 软 件 架 构 
风格 。 目 前 在 三 种 主流 的 Web 服 务实 现 方 案 中 ，REST 模 式 与 复杂 的 SOAP 和 XML-RPC 相 比 更 加 简洁 ， 越 来 越 多 的 Web 服 务 开 始 采 用 REST 风 格 设 计 和 实现 。REST 是 设计 风格 而 不 是 标准 ，REST 通 常 基 于 使 
用 HTTP、URI、XML、JSON 和 HTML 这 些 现 有 的 协议 和 标准 来 实现 。 


REST 风 格 具 有 以 下 特点 : 

1) 资源 一 般 由 URI 来 指定 。 

2) 无 状态 通信 。 

3) 对 资源 的 操作 包括 创建 、 获 取 、 修 改 和 删除 等 ， 这 些 操作 对 应 HTTP 的 GET、POST、PUT 和 DELETE 方 法 。 
4) 资源 的 表现 形式 可 以 是 XML、JSON 或 HTML 格 式 文 件 。 


REST 设 计 风格 确实 可 以 带 来 一 些 好 处 ， 这 些 好 处 使 Web 开 发 更 加 简洁 上 且 易 于 实现 。REST 风 格 可 以 使 资源 的 定义 方式 更 加 清晰 ，Web 服 务 器 中 常常 保存 很 多 不 同类 型 的 资源 ， 这 些 资源 需要 通过 某 种 约 
定 俗 成 的 方法 加 以 编号 ， 若 遵循 REST 风 格 那么 www.wsncoap.org 中 某 个 具体 的 资源 可 能 采用 这 样 的 URI 定 义 : http://wsncoap.org/resources/15。 


REST 风 格 使 得 对 资源 的 操作 变 得 更 加 简洁 ， 若 采用 REST 风 格 可 充分 利用 HTTP 中 已 经 使 用 的 各 种 “动词 ”一 GET、PUT、POST 和 DELETE。GET 代 表 获 取 、PUT 代 表 更 新 、POST 代 表 创 建 而 DELETE 
代表 删除 ， 这 就 避免 了 在 HTTP 负 载 部 分 还 需要 创建 诸如 Create 或 Update 这 样 “ 非 标准 ”的 动作 。 另 外 ，HTTP 中 4 个 常用 方法 也 对 应 数据 库 中 的 “增删 改 查 ”四 大 操作 。 表 1-1 可 以 很 好 地 说 明 在 REST 风 格 
指导 下 如 何 使 用 HTTP 中 的 4 个 常用 方法 操作 wsncoap.org/resources/15 资 源 。 


表 1-1 REST 风 格 资源 操作 说 明 
HTTP 方法 操作 说 明 


获取 动作 : 获取 指定 资源 的 详细 信息 ， 格 式 可 以 为 文本 格式 、JSON 格式 、 
XML 格式 等 。 资 源 的 媒体 类 型 可 以 由 客户 端 指定 


PUT 更 新 动作 : 更 新 指定 的 资源 ， 并 将 其 退 加 到 相应 的 资源 组 中 
创建 动作 : 把 指定 的 资源 当 作 一 个 资源 组 ， 在 其 下 创建 /人 奶 加 一 个 新 的 元 


GET 


ida 素 ,使 其 隶属 于 当前 资源 
DELETE 删除 动作 : 删除 指定 的 资源 


1.4 物 联 网 与 CoAP 


CoAP 是 受 限 制 的 应 用 协议 (Constrained Application Protocol) 的 简称 。 随 着 最 近 几 年 物 联 网 技术 的 发 展 ， 越 来 越 多 的 设备 接 入 互联 网 。 据 预测 未 来 将 有 更 多 的 设备 需要 相互 连接 ， 而 这 些 设备 的 数 
量 将 远 超人 类 的 总 和 。 在 这 种 大 背景 下 ， 物 联网 1oT 和 M2M 技 术 应 运 而 生 。 昌 然 对 人 们 而 言 ， 接 入 互联 网 显得 非常 方便 ， 但 是 对 于 那些 低 功 耗 受 限 制 设备 而 言 接 入 互联 网 却 异 常 困 难 。 在 当前 由 PC 和 智能 


机 组 成 的 世界 里 ， 信 息 交 换 多 是 通过 TCP 和 应 用 层 协议 HTTP 实 现 的 。 但 是 对 于 低 功 耗 受 限 制 设备 而 言 ， 实 现 TCP 和 HTTP 显 然 是 一 个 过 分 而 苛刻 的 要 求 。 为 了 让 低 功 耗 受 限制 设备 可 以 接 入 互联 网 ，COAP 应 
运 而 生 。CoAP 是 一 种 应 用 层 协议 ， 它 运行 于 UDP 之 上 而 不 是 像 HTTP 那 样 运行 于 TCP 之 上 。CoAP 非 常 小 巧 ， 最 小 的 数据 包 仅 为 4 字 节 。 


1.4.1 


COAP 


COoAP 并 不 能 孤立 存在 ， 而 是 TCP/IP 协 议 族 的 一 部 分 。TCP/IP 为 人 熟知 ， 从 字面 意思 上 理解 TCP/IP 指 TCP 与 |P 这 两 种 协议 ， 但 实际 上 TCP/IP 是 一 类 协议 集合 的 统称 ， 具 体 来 说 TCP/IP 包 括 IP 和 ICMP、 
TCP 和 UDP、TELNET 和 FTP 等 。 虽 然 CoOAP 并 没有 使 用 TCP 作 为 传输 层 协议 ,但 CoAP 也 属于 TCP/IP 协 议 族 中 的 一 员 。CoAP 借 鉴 了 HTTP 的 大 量 成 功 经 验 ，CoAP 和 HTTP 一 样 均 使 用 请 求 /响应 工作 模式 。 通 
常 由 客户 端 发 送 CoAP 请 求 ， 服 务 器 一 旦 侦 听 到 该 请 求 便 会 根据 请 求 内 容 返 回响 应 码 和 响应 内 容 。 图 1-6 可 以 很 好 地 说 明 CoAP 请 求 /响应 工作 模式 的 大 致 流程 。 虽然 CoOAP 和 HTTP 有 很 多 相似 之 处 ， 但 是 
CoAP 专 门 为 低 功 耗 受 限制 设备 设计 ， 它 比 HTTP 简 单 很 多 。 


coap://wsncoap.org 


客户 端 


GET /hello 


CoAP 请 求 


2.05 Content 


CoAP 响 应 Hello CoAP 


图 1-6 ”CoAP 请 求 /响应 工作 模式 


1.4.2 RFC C 


俗话 说 “没有 规矩 不 成 方圆 ”， 这 些 TCP/IP 相 关 协 议 均 由 IETF 组 织 讨 论 并 制定 ，IETF 组 织 是 一 个 坚持 开放 性 和 适用 性 的 国际 标准 化 组 织 ， 该 组 织 产生 的 标准 化 文档 被 称 为 RFC (Request For 
Comment) 文档 ， 所 有 RFC 文 档 完 全 公开 并 在 互联 网 上 公布 。RFC 文 档 不 仅 记 录 了 协议 规范 内 容 ， 还 包括 协议 的 实现 和 运用 的 相关 信息 。RFC 文 档 通 过 编号 的 方式 组 织 每 个 协议 的 标准 化 请 求 ， 如 著名 的 IP 
规范 由 RFC 279 规 定 ， 而 著名 的 TCP 规 范 则 由 RFC 793 规 定 ， 本 书 讨论 的 CoAP 由 RFC 7252 规 定 。RFC 编 号 采用 递增 方式 编号 ， 著 名 的 IP 和 TCP 的 编号 仪 为 3 位 数字 ， 而 CoAP 的 编号 已 经 超过 7000。 


通过 上 面 的 分 析 不 难得 出 ， 若 需要 熟悉 并 了 解 COAP 可 从 RFC 文 档 入 手 ， 通 过 CoAP 相 关 的 RFC 文 档 可 以 了 解 它 的 “前 世 今 生 ”。 


1.CoAP 核 心 与 扩展 协议 


CoAP 包 括 核 心 协议 RFC 7252 和 扩展 协议 RFC 7641, RFC 6690 和 RFC 7959 等 部 分 ， 具 体内 容 见 表 1-2。 本 书后 续 章节 将 结合 示例 详细 解释 这 几 份 RFC 文 档 。 


表 1-2 ”CoAP 核 心 协 议和 扩展 协议 


名 称 RFC 编号 RFC 文档 名 称 
CoAP 核心 协议 RFC 7252 The Constrained Application Protocol (CoAP) 


Observing Resources 1n the Constrained Application Protocol 


CoAP 观察 者 模式 RFC 7641 
o AP 观察 者 模式 (CoAP) 


CoAP 资源 描述 RFC 6690 Constrained RESTful Environments (CoRE) Link Format 


Block-Wise Transfers in the Constrained Application Protocol 


块 传输 
CoAP 块 传 输 RFC 7959 (CoAP) 


2.TCP/IP 相 关 RFC 文 档 汇总 


CoAP 的 应 用 还 依赖 于 其 他 RFC 文 档 ， 在 这 些 RFC 文 档 的 共同 支持 下 才 可 以 组 成 完整 的 CoAP 应 用 。CoAP 依 赖 的 RFC 文 档 见 表 1-3。 


表 1-3 TCP/IP 相 关 RFC 文 档 汇 总 


名 称 RFC 文档 名 称 

IPv4 说 明 Internet Protocol Specification 

ICMP 说 明 Internet Control Message Protocol 

UDP 说 明 User Datagram Protocol 

TCP 说 明 Transmission Control Protocol 

" cn 

DHCP 说 明 Dynamic Host Configuration Protocol 

HTTP 1.1 说 明 Hypertext Transfer Protocol 

HTTP 2.0 说 明 Hypertext Transfer Protocol Version 2 (HTTP/2) 

IPv6 说 明 Internet Protocol, Version 6 (IPv6) Specification 

DHCPv6 说 明 Dynamic Host Configuration Protocol for IPv6 (DHCPv6) 
- Stateful NAT64: Network Address and Protocol Translation 

NAT64 说 明 from IPv6 Clients to IPv4 Servers 

IPv6 over IEEE 802.15.4 Transmission of IPv6 Packets over IEEE 802.15.4 Networks 

IPv6 over BLE IPv6 over BLUETOOTH(R) Low Energy 

ISON 格式 说 明 NN EN Object Notation (JSON) Data Interchange 
£ R RFC 文档 名 称 

CBOR 格式 说 明 Concise Binary Object Representation (CBOR) 

TLS 1.2 协议 说 明 The Transport Layer Security (TLS) Protocol Version 1.2 

DTLS 说 明 Datagram Transport Layer Security Version 1.2 


1.5. 物 联网 与 MQTT 协 议 


与 HTTP 和 CoAP 不 同 ，MQTT 协 议 由 IBM 牵 头 制定 ， 而 HTTP 与 COAP 均 由 IETF 组 织 制定 。MQTT 协 议 采 用 订阅 /发 布 模式 ， 这 与 HTTP 和 CoAP 的 请 求 /响应 模式 存在 明显 区 别 。M QTT 协 议 虽 然 不 是 为 物 


联网 应 用 专门 设计 的 协议 ， 但 是 在 物 联网 领域 依然 取得 了 不 俗 的 成 绩 。 


1.5.1 MQTT 协 议 


MQ 遥测 传输 (MQTTI) 是 轻 量 级 基于 代理 的 发 布 /订阅 模式 的 消息 传输 协议 ，MQTT 协 议 开放 、 简 单 、 轻 量 级 且 易 于 实现 。 该 协议 的 特点 有 : 
1) 使 用 发 布 /订阅 消息 模式 ， 提 供 一 对 多 的 消息 发 布 ， 解 除 应 用 程序 看 合 。 

2) 对 负载 内 容 屏 项 的 消息 传输 。 

3) 使 用 TCP/IP 提 供 网 络 连接 。 

4) 小 型 传输 ， 网 络 传输 开销 非常 小 (固定 长 度 的 头 部 是 2 字 节 ) ， 协 议 交换 最 小 化 以 降低 网 络 流量 。 

5) 使 用 Last Will 和 Testament 特 性 通知 有 关 各 方 客户 端 异常 中 断 的 机 制 。 


[1] http:/ /mqtt.org/ o 


1.5.2 MQTT 主 题 


MQTT 协 议 包 含 一 个 主题 的 概念 ，MQTT 的 主题 与 HTTP 中 的 资源 URI 较 为 相似 。MQTT 协 议 通 过 主题 对 消息 进行 分 类 ， 主 题 本 质 上 是 一 个 UTF-8 编 码 的 字符 串 ， 可 通过 斜 杠 表示 多 个 层级 关系 。 主 


H 


题 还 


可 以 使 用 通配符 进行 过 滤 。 其 中 ，“+” 可 以 过 滤 一 个 层级 ， 而 “#” 只 能 出 现在 主题 最 后 ， 表 示 过 滤 任 意 级 别 的 层级 。 
下 面 是 几 个 常见 的 MQTT 主 题 : 
1) building-b/floor-5: 表示 B 栋 楼 第 5 层 。 
2) +/floor-5: 表示 任何 一 栋 楼 的 第 5 层 。 


3) building-b/#: 表示 B 栋 楼 的 所 有 楼 层 。 


1.5.5 ”MQTT 服 务 质 量 


针对 不 同 的 应 用 场景 ，MQTT 协 议 提供 三 种 不 同 消息 发 布 服务 质量 : 


“QoS=0 “最 多 一 次 ”: 服务 质量 级 别 QoS0 是 最 快 的 传输 方式 ， 有 时 称 为 “触发 并 忘记 ”。 消 息 将 最 多 传递 一 次 ， 或 者 可 能 完全 不 会 传递 。 网 络 中 的 传递 不 会 得 到 确认 ， 并 且 不 会 存储 消息 。 如 果 客 户 
E 自 


机 断 开 连接 或 者 服务 器 发 生 故 障 ， 那 么 消息 可 能 会 丢失 。 以 某 个 时 间 间 隔 发 送 实时 数据 时 ， 可 使 用 服务 质量 级 别 QoS0。 委 失 单条 消息 实际 上 不 会 产生 很 大 影响 ， 因 为 之 后 很 快 将 发 送 包 含 较 新 数据 的 另 一 条 


消息 。 在 此 场景 中 ， 使 用 较 高 服务 质量 会 带 来 额外 成 本 ， 却 不 会 获得 任何 实际 优势 。QoS=0 的 情况 如 图 1-7a 所 示 。 


: QoS=1 “至 少 一 次 ”: 使 用 服务 质量 级 别 QoS1 时 消息 会 始终 至 少 传递 一 次 。 如 果 发 布 者 收 到 应 答 之 前 消息 传递 失败 ， 那 么 一 条 消息 可 能 会 传递 多 次 。 该 消息 必须 存储 在 发 布 者 本 地 ， 直 到 发 布 者 收 到 
关于 接收 者 已 发 布 此 消息 的 确认 消息 为 止 。QoS=1 的 情况 如 图 1-7b 所 示 。 

: QoS=2“ 恰 好 一 次 ”: 服务 质量 级 别 QoS2 是 最 安全 也 是 最 慢 的 传输 方式 。 消 息 始终 传递 恰好 一 次 ， 并 且 必 须 存储 在 发 布 者 本 地 ， 直 到 发 布 者 收 到 关于 接收 者 已 发 布 此 消息 的 确认 消息 为 止 。 使 用 服务 
质量 级 别 QoS2 时 会 采用 比 QoS1 更 复杂 的 握手 和 应 答 序 列 ， 以 确保 消息 不 会 重复 。QoS=2 的 情况 如 图 1-7c 所 示 。 


PUBLISH 


PUBLISH 
\ PUBACK 一 一 > 


PUBLISH 


: PUBREC 
! PUBREL 
PUBCOMP 


| 
c) QoS=2 
图 1-7 MQTT 消 息 发 布 服务 质量 


与 HTTP 和 CoAP 的 请 求 /响应 模式 不 同 ，MQTT 协 议 这 样 的 订阅 /发 布 模式 总 是 存在 三 个 不 同 的 角色 一 一 发 布 者 、 代 理 器 (Broker) 和 订阅 者 。 订 阅 者 向 MQTT 代 理 器 订阅 单个 或 一 系列 主题 ， 发 布 者 发 
布 某 个 主题 的 具体 消息 。 在 MQTT 代 理 器 的 协调 下 ， 所 有 订阅 者 将 及 时 收 到 该 主题 的 消息 。MQTT 协 议 的 工作 过 程 经常 被 称 为 “推送 ”， 在 推送 过 程 中 某 些 消息 必须 保证 稳定 可 靠 ， 而 某 些 消息 允许 丢失 或 
收 到 重复 内 容 。 为 了 实现 这 种 灵活 可 变 的 机 制 ，MQTT 协 议 提 供 了 以 上 三 种 不 同 的 消息 发 布 服务 质量 。 


1.6 EJA 


本 章 介绍 了 物 联 网 应 用 相关 的 多 种 协议 ， 这 些 协 议 包 括 IPv4、IPv6、6LoWPAN、HTTP、CoAP 和 MQTT 等 ， 灵 活 使 用 这 些 协议 将 组 成 各 种 各 样 的 物 联网 应 用 。IPv4、IPv6 和 6LoWPAN 是 物 联网 应 用 的 基 
础 ，IPv4 在 互联 网 领域 取得 卓越 的 成 就 ， 但 是 IPv4 地 址 空间 短缺 依然 是 物 联网 大 规模 应 用 的 “痛处 ”，IPv6 无 疑 将 会 在 物 联网 中 取得 越 来 越 多 的 应 用 。 现 阶段 物 联 网 设备 依然 属于 受 限 制 低 功 耗 设备 ， 这 些 
设备 无 法 像 非 受 限 制 设备 那样 完整 地 使 用 IPv6， 需 要 通过 6LoWPAN 头 压缩 技术 降低 协议 本 身 的 传输 开销 。 除 了 这 些 基 础 协议 之 外 ， 本 章 还 讨论 了 3 种 应 用 层 协议 
采用 请 求 / 响 应 模式 ， 而 MQTT 采 用 订阅 /发 布 模式 ， 其 中 HTTP 已经 取得 广泛 的 应 用 ， 它 的 成 熟 经 验 也 被 CoAP 的 制定 所 借鉴。 本 章 还 列举 了 CoAP 的 相关 RFC 文 档 ， 本 书 的 后 续 章节 将 结合 具体 的 示例 对 这 些 


RFC 文 档 进 行 详细 说 明 。 


HTTP、CoAP 和 MQTT，HTTP 和 CoAP 均 


本 章 的 重点 并 不 是 为 了 说 明 CoAP， 而 是 为 了 说 明 CoAP 并 不 是 凭空 捏造 的 ， 也 不 能 脱离 其 他 网 络 技 术 独 立 存 在 。CoAP 将 成 为 物 联 网 应 用 的 重要 组 成 部 分 ， 它 将 与 其 他 应 用 层 协 议 一 起 组 成 多 姿 多 彩 的 物 


联网 应 用 。 


第 2 和 章 ” 物 联网 与 开源 硬件 


2.1 本 章 主要 内 容 


本 章 将 介绍 两 种 在 物 联网 领域 中 常用 的 开源 硬件 一 Arduino 和 树 长 派 。Arduino 和 树 莓 派 是 开源 硬件 领域 的 明星 产品 ，Arduino 和 树 伏 派 不 但 功能 强大 ， 而 且 价 格 便宜 易于 购买 。Arduino 和 树 莓 派 均 
具有 常用 普通 1O 接 口 、SPI 接 口 、12C 接 口 和 UART 接 口 等 ， 可 通过 各 种 各 样 的 传感器 与 物理 世界 产生 联系 ; 除了 物理 世界 的 感知 能 力 之 外 ，Arduino 和 树 莓 派 还 具有 一 定 的 网 络 连 接 能 力 ， 通 过 网 络 连 接 能 
把 物理 世界 的 信息 传递 至 互联 网 中 。Arduino 和 树 莓 派 既 可 以 作为 物 联网 系统 的 终端 节点 ， 也 可 以 作为 整个 系统 的 中 转 设备 或 枢纽 设备 。 


\ 一 /一 


Arduino 和 树 伏 派 虽 然 功能 相似 ， 但 是 也 存在 一 定 的 区 别 。Arduino 属 于 低 功 耗 受 限制 设备 范畴 ; 而 树 莓 派 属于 非 受 限制 设备 ， 可 以 运行 Linux 系 统 并 具有 普通 PC 的 大 多 数 功能 。CoAP 不 但 可 以 运行 于 
Arduino 平 台 ， 也 可 以 运行 于 树 莓 派 平 台 。 本 章 重 点 介绍 几 款 常用 的 Arduino 和 树 莓 派 型 号 。 


第 2 章 ” 物 联网 与 开源 硬件 


2.1 本 章 主要 内 容 


本 章 将 介绍 两 种 在 物 联网 领域 中 常用 的 开源 硬件 一 Arduino 和 树 莓 派 。Arduino 和 树 莓 派 是 开源 硬件 领域 的 明星 产品 ，Arduino 和 树 伏 派 不 但 功能 强大 ， 而 且 价 格 便宜 易于 购买 。Arduino 和 树 莓 派 均 
具有 常用 普通 1O 接 口 、SPI 接 口 、12C 接 口 和 UART 接 口 等 ， 可 通过 各 种 各 样 的 传感器 与 物理 世界 产生 联系 ; 除了 物理 世界 的 感知 能 力 之 外 ，Arduino 和 树 莓 派 还 具有 一 定 的 网 络 连 接 能 力 ， 通 过 网 络 连 接 能 力 
把 物理 世界 的 信息 传递 至 互联 网 中 。Arduino 和 树 莓 派 既 可 以 作为 物 联网 系统 的 终端 节点 ， 也 可 以 作为 整个 系统 的 中 转 设备 或 枢纽 设备 。 


Arduino 和 树 莓 派 虽 然 功 能 相似 ， 但 是 也 存在 一 定 的 区 别 。Arduino 属 于 低 功 耗 受 限 制 设备 范畴 ; 而 树 莓 派 属 于 非 受 限制 设备 ， 可 以 运行 Linux 系 统 并 具有 普通 PC 的 大 多 数 功能 。CoAP 不 但 可 以 运行 于 
Arduino 平 台 ， 也 可 以 运行 于 树 莓 派 平 台 。 本 章 重点 介绍 几 款 常用 的 Arduino 和 树 莓 派 型 号 。 


2.2 Arduino 


2.2.1 Arduino 

Arduino 是 一 款 便捷 灵活 、 方 便 上 手 的 开源 电子 设计 原型 平台 。Arduino 包 含 硬件 和 软件 两 部 分 ， 硬 件 部 分 包含 各 种 Arduino 开 发 板 和 扩展 板 ， 软 件 部 分 包括 Arduino IDE、 驱 动 扩展 库 和 应 用 扩展 库 等 
部 分 。Arduino 使 用 Processing/Wiring 作 为 开发 语言 ， 该 开发 语言 具有 很 多 Java 和 (C 语 言 特 性 ， 上 手 简 单 上 且 容 易学 习 。 

Arduino 具 有 以 下 特点 : 

1) 跨 平台 : Arduino IDE 可 以 在 Windows、Mac OS、Linux 三 大 主流 操作 系统 上 运行 。 


2) 简单 清晰 : Arduino IDE 基 于 Processing 1DE 开 发 。 对 于 初学 者 来 说 ， 极 易 掌 握 ， 同 时 具有 足够 的 灵活 性 。Arduino 语 言 基 于 Wiring 语 言 开发 ， 是 对 avr-gcc 库 的 二 次 封装 ， 不 需要 太 多 的 单片机 基 
础 、 编 程 基础 ， 简 单 学 习 后 就 可 以 进行 快速 开发 。 


3) 开放 性 : Arduino 的 硬件 原理 图 、 电 路 图 、1DE 软 件 及 核心 库 文 件 都 是 开源 的 ， 在 开源 协议 范围 内 里 可 以 任意 修改 原始 设计 及 相应 代码 。 


4) 发 展 迅速 : Arduino 不 仅仅 是 全 球 最 流行 的 开源 硬件 ， 也 是 一 个 优秀 的 硬件 开发 平台 ， 是 硬件 开发 的 趋势 。Arduino 简 单 的 开发 方式 使 得 开发 者 更 关注 创意 与 实现 ， 更 快 地 完成 项 目 开 发 ， 大 大 节约 
了 学 习 成 本 ， 缩 短 了 开发 周期 。 


2.2 Arduino 


2.2.1 ArduinofS jr 

Arduino 是 一 款 便捷 灵活 、 方 便 上 手 的 开源 电子 设计 原型 平台 。Arduino 包 含 硬 件 和 软件 两 部 分 ， 硬 件 部 分 包含 各 种 Arduino 开 发 板 和 扩展 板 ， 软 件 部 分 包括 Arduino IDE、 驱 动 扩 展 库 和 应 用 扩展 库 等 
部 分 。Arduino 使 用 Processing/Wiring 作 为 开发 语言 ， 该 开发 语言 具有 很 多 Java 和 (语言 特性 ， 上 手 简单 且 容 易学 习 。 

Arduino 具 有 以 下 特点 : 

1) 跨 平台 : Arduino IDE 可 以 在 Windows、Mac OS、Linux 三 大 主流 操作 系统 上 运行 。 


2) 简单 清晰 : Arduino IDE 基 于 Processing 1DE 开 发 。 对 于 初学 者 来 说 ， 极 易 掌 握 ， 同 时 具有 足够 的 灵活 性 。Arduino 语 言 基 于 Wiring 语 言 开发 ， 是 对 avr-gcc 库 的 二 次 封装 ， 不 需要 太 多 的 单片机 基 
础 、 编 程 基础 ， 简 单 学 习 后 就 可 以 进行 快速 开发 。 


3) 开放 性 : Arduino 的 硬件 原理 图 、 电 路 图 、IDE 软 件 及 核心 库 文件 都 是 开源 的 ， 在 开源 协议 范围 内 里 可 以 任意 修改 原始 设计 及 相应 代码 。 


是 硬件 开发 的 趋势 。Arduino 简 单 的 开发 方式 使 得 开发 者 更 关注 创意 与 实现 ， 更 快 地 完成 项 目 开 发 ， 大 大 节约 


4) 发 展 迅 速 : Arduino 不 仅仅 是 全 球 最 流行 的 开源 硬件 ， 也 是 一 个 优秀 的 硬件 开发 平台 


了 学 习 成 本 ， 缩 短 了 开发 周期 。 


下 面 介 绍 两 款 常 用 的 Arduino 型 号 : Arduino UNO 和 Arduino 101, 


Arduino UNOLI 是 Arduino USB 接 口 系列 的 最 新 版 本 ， 作 为 Arduino 平 台 的 参考 标准 模板 。Arduino UNO 的 核心 处 理 器 为 ATmega328， 它 同时 具有 14 路 数字 输入 输出 口 (其 中 5 路 可 作为 PWM 输 
一 个 ICSP 插 座 和 一 个 复位 按钮 。Arduino UNO 的 外 观 如 图 2-1 所 示 。 


) 、6 路 模拟 输入 、 一 个 16MHz 晶 体 振荡 器 、 一 个 USB 口 、 一 个 电源 插座 、 
UNO 已 经 发 布 到 第 三 版 ,与 前 两 版 相 比 该 版 本 有 以 下 新 的 特点 : 

1) 在 AREF 处 增加 了 两 个 管 脚 SDA 和 SCL， 支 持 I2C 接 口 。 

2) 增加 IOREF 和 一 个 预 留 管 脚 ， 扩 展板 将 能 兼容 5V 和 3.3V 核 心 板 。 

3) 改进 了 复位 电路 设计 。 


4) USB 接 口 芯片 由 ATmega16U2 替 代 了 ATmega8U2。 
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图 2-1 Arduino UNO 外观 


Arduino 101/71 —^4 MV ESELHESBOIIZDRETER TS, voi-FIntel Curie 模 组 ， 价 格 便宜 ， 使 用 简单 。101 不 仅 有 着 与 UNO 一 样 的 特性 和 外 设 ， 还 额外 增加 了 Bluetooth LE 和 6 轴 加 速 计 、 陀 螺 仪 。Intel 
6 个 模拟 输入 、 一 个 用 于 串口 通信 和 上 传 程序 的 


Curie 模 组 包含 一 个 x86 的 夸克 核心 和 一 个 32 位 的 ARC 架 构 核 心 Zephyr， 时 钟 频 率 均 为 32MHz。Arduino 101 具 有 14 路 I/O 口 (其 中 4 路 可 用 作 PWM 输 出 ) 、 


USB 接 口 、1 个 电源 插座 、1 个 带 SPIl 和 12C 脚 的 ICSP 接 口 。Arduino 101 的 外 观 如 图 2-2 所 示 。 


图 2-2 Arduino 101 2| 3L 


[1] https:/ /www.atduino.cc/en/Main/ ArduinoBoardUno, 


[2] https:/ /www.arduino.cc/en/Main/ ArduinoBoard101 ; 


2.2.3 Arduino 扩 展 接口 


Arduino 的 成 功 得 益 于 它 的 标准 化 扩展 接口 ， 通 过 扩展 接口 ，Arduino 可 以 扩展 各 种 各 样 的 传感器 检测 功能 、 执 行 设备 控制 功能 和 网 络 连 接 功能 。Arduino 可 通过 具有 输入 和 输出 功能 的 普通 1O 口 控制 
LED 或 蜂 鸣 器 等 低 功 率直 流 设备 ， 也 可 以 通过 操作 继电器 的 方式 间接 控制 大 功率 交流 设备 ; Arduino 具 有 多 路 模拟 量 输入 接口 ， 通 过 这 些 模拟 量 输入 接口 Arduino 可 以 连接 多 种 传感器 ， 如 具有 模拟 量 输入 功 
能 的 角度 传感器 、 三 轴 角 速度 传感器 等 ; Arduino 具 有 多 路 PWM 输出 接口 ， 通 过 PWM 输出 接口 Arduino 可 以 实现 直流 电机 调 速 等 功能 ; Arduino 还 具有 |2C 接 口 和 SPI 接 口 ，Arduino 可 通过 这 两 种 常用 的 接 
口 扩 展 各 种 各 样 的 芯片 ， 如 Arduino 可 通过 SPI 接 口 扩展 网 卡 芯 片 W5100， 通 过 W5100 使 Arduino 具 有 有 线 网 络 功能 。 表 2-1 为 Arduino 扩 展 接口 说 明 。 


表 2-1 Atrduino 扩 展 接 口 说 明 


编 号 单 睛 机 引 脚 复 用 功能 


] PDI UART TXD 


2 PD2 外 部 中 断 INTO 
3 PD3 外 部 中 断 INT1 / PWM 输出 通道 0 


PD5 PWM 输出 通道 1 
PWM 输出 通道 2 
D 
PB0 


Doco il 和 | 
"y 
N 


pà 
© 
ry 
N 


PBI PWM 输出 通道 3 


B SPI SS / PWM 输出 通道 4 
11 PB3 SPI MOSI / PWM 输出 通道 5 
12 PB4 SPI MISO 
13 PB5 SPI SCK 
A0 PCO 模拟 量 输入 通道 0 
Al 模拟 量 输 入 通道 1 
A2 PC2 模拟 量 输入 通道 2 
A3 PC3 模拟 量 输入 通道 3 
A4 模拟 量 输入 通道 4/I2C SDA 
AS PCS 模拟 量 输入 通道 5 /IC SCL 


2.3. WER 


2.3.4. WERKE 


树 莓 派 是 一 款 具有 单片机 功能 的 小 型 Linux 开 发 板 ， 基 于 ARM 的 微型 电脑 主机 ， 以 SD 或 MicroSD 卡 为 存储 硬盘 ， 主 板 周 围 有 多 个 USB 接 口 和 一 个 10/100Mbit/s 以 太 网 接口 。 它 可 连接 键盘 、 鼠 标 和 网 
线 ， 同 时 拥有 HDM| 高 清 视频 输出 接口 。 树 莓 派 功能 强大 且 接 口 丰富 ， 但 各 种 部 件 却 整合 在 一 张 仅 比 信用 卡 稍 大 的 主板 上 。 


2.3 WER 


2.3.1 PIERKE 


树 莓 派 是 一 款 具 有 单片机 功能 的 小 型 Linux 开 发 板 ， 基 于 ARM 的 微型 电脑 主机 ， 以 SD 或 MicroSD 卡 为 存储 硬盘 ， 主 板 周围 有 多 个 USB 接 口 和 一 个 10/100Mbit/s 以 太 网 接口 。 它 可 连接 键盘 、 鼠 标 和 网 
线 ， 同 时 拥有 HDM| 高 清 视频 输出 接口 。 树 莓 派 功能 强大 且 接 口 丰 富 ， 但 各 种 部 件 却 整合 在 一 张仪 比 信用 卡 稍 大 的 主板 上 。 
2.3.2” 单 用 树 每 派 型 号 


市 面 上 流行 多 种 型 号 的 树 莓 派 ， 常 见 的 有 树 葡 派 2 代 B 型 ( 见 图 2-3) ERABE ( 见 图 2-4) 四 。 树 莓 派 2 代 B 型 和 树 莓 派 3 代 B 型 在 外 观 上 并 没有 明显 的 区 别 ， 功 能 和 性 能 方面 树 莓 派 2 代 B 型 和 树 
莓 派 3 代 B 型 也 相差 不 大 。 


Résphberry Pl 2 Medel B YL. 
(日 Rospbherry Pi 


au » 


| Qilsa en — 


Bittin li 


(EELEIT 


es 49,5. mm 
git? ba. Cocot 


s H ttgintiiiiirii 
" 


F] L] | 
i 


au wl Quac 


t 


ML. 
Rios. 


| m as w^ 
T-d mc 


a 

-1 

" 

L3 

- Ell 
SRMAEJJJIMSEE 


Wade Te The W 


| GTE 
gue a 4. 


图 2-3 BIA KON B?H IpI 


"CHA 
Respherry Fl 3 Model B Vi.2 
Raspberry Pl 2015 
S Ran 


Wede ia the S 


Rio 


s, e 


EIE eere e Lt -sa 


z : E: 
CHé Cac o. 


IE-L-IE 
LLLI XE. 


z—A— —ÁMM— € n e- cm 


11 
FOC 10: 2ABCB-89132 
IC: 20951-89132 


"293 02 2822112232111 


LLLALL S A 


ETETETT EE EEE. 
E aH 


图 2-4 B JR BA TAL 


树 莓 派 3 代 B 型 与 树 莓 派 2 代 B 型 具有 相同 的 40 引 脚 外 部 扩展 接口 ， 树 莓 派 3 代 采用 了 更 高 主 频 的 CPU， 并 内 置 了 无 线 网 卡 和 低 功 耗 监 牙 功 能 ， 但 售 价 与 树 莓 派 2 代 B 型 同 为 35 美 元 ， 这 使 得 树 莓 派 3 代 B 型 越 
来 越 流行 。 


1. 树 每 派 2 代 B 型 


树 莓 派 2 代 B 型 主板 采用 博通 BCM2836 的 四 核 CPU， 主 频 可 达 900 M Hz。 树 莓 派 2 代 B 型 具有 1 GB 内 存 。 相 较 于 之 前 的 树 莓 派 版 本 ，CPU 主 频 和 板 载 内 存 均 大 幅度 提升 ， 所 以 树 莓 派 的 综合 性 能 获得 了 广 
泛 的 认可 。 树 莓 派 2 代 B 型 不 但 能 运行 全 系列 ARM GNU/Linux 发 行 版 ， 而 且 还 支持 Snappy Ubuntu Core 及 Windows 10 等 操作 系统 。 


树 莓 派 2 代 B 型 主要 配置 如 下 : 


博通 BCM2836900MHz 四 核 ARM Cortex-A7 CPU. 


. 1GB 板 载 内 存 。 


- 10/100Mbit/s 自 适应 网 卡 接 口 。 


- 4 个 USB 2.0 接 口 。 


: Micro SD 卡 插 槽 。 


: microUSB 供 电 接口 。 


: 3.5 mm 音频 输出 接口 。 


- 40PIN GPIO 扩 展 接 口 。 


: HDMI 接 口 。 


| 摄像 头 接 口 。 


"LCD 接口 。 


2. SEJK3 RBE 


树 莓 派 3 代 B 型 是 最 新 型 号 的 树 莓 派 开发 板 ， 该 主板 采用 64 位 1.2 GHz 主 频 的 四 核 CPU， 性 能 相对 于 树 莓 派 2 代 B 型 提升 了 约 50%。 


树 莓 派 3 代 B 型 内 置 了 无 线 网 卡 以 及 蓝牙 ， 而 树 莓 派 2 代 B 型 仅 内置 了 有 线 网 卡 ， 


如 果 想 要 之 前 的 树 莓 派 版 本 支持 无 线 网 络 或 低 功 耗 监 牙 功能 ， 则 需要 自行 添加 USB WiF 适配器 或 USB BLE 适 配器 ， 而 对 于 


树 莓 派 3 代 B 型 来 说 则 无 需 购 买 这 些 额外 配件 。 所 以 树 莓 派 3 代 B 型 是 一 款 开 箱 即 用 的 物 联 网 开发 工具 。 


除了 增加 网 络 连接 功能 、 提 升 处 理 器 性 能 之 外 ， 树 莓 派 3 代 B 型 还 升级 了 USsB 电 源 管 理 部 分 ， 树 莓 派 3 代 B 型 USB 部 分 的 最 大 输出 电流 可 达 2.5 A， 所 以 该 系列 树 莓 派 可 支持 更 多 更 强大 的 外 部 USB 设 备 。 


树 莓 派 3 代 B 型 主要 配置 如 下 : 
. 博通 BCM28371.2GHz 四 核 ARM 64 位 CPU。 
- 1GB 内 存 。 
C 板 载 无 线 网 卡 和 低 功 耗 蓝牙 。 
- 10/100Mbit/s 自 适应 网 卡 接口 。 
- 4 个 USB 2.0 接 口 。 
: 升级 USB 电源 ， 最 大 输出 可 达 2.5 Ao 
: Micro SD 卡 插 模 。 
. mictoUSB 供 电 接口 。 
: 3.5 mm 音频 输出 接口 。 
. 40PIN GPIO 扩 展 接口 。 
: HDMI 接 口 。 
CAR dE. 
: LCD 接 口 。 


[1] https:/ /www.raspbetrypi.org/products/raspbetry-pi-2-model-b/ o 
[2] https:/ /www.raspbetrypi.org/products/raspbetry-pi-3-model-b/ o 


2.3.3 ” 树 每 派 扩展 接口 


树 莓 派 的 成 功 不 但 得 益 于 它 卓 越 的 性 能 、 便 宜 的 价格 ， 还 与 它 与 生 俱 来 的 GPIO 扩 展 接口 有 关 。 树 莓 派 GPIO 扩 展 接 口 共 有 40 个 引 脚 ， 这 些 引 脚 包括 具有 输入 输出 功能 的 普通 IO、SPI 接 口 、12C 接 口 和 
UART 接 口 等 ; 这 些 扩展 接口 使 树 莓 派 能 够 控制 各 种 各 样 的 硬件 。 通 过 GPIO 扩 展 接口 ， 树 莓 派 可 非常 方便 地 控制 LED 和 蜂 鸣 器 等 低 功率 设备 ; 树 莓 派 也 可 以 通过 GPIO 控 制 继 电器 的 方式 ， 控 制 直 流 大 功率 设 
备 或 者 高 压 交 流 设 备 ; 树 莓 派 GPIO 扩 展 接 口 还 具有 12C 接 口 和 SPI 接 口 ， 通 过 这 两 种 接口 可 以 连接 多 种 数字 传感器 ， 如 三 轴 加 速度 传感器 ADXL345、 三 轴 加 速度 /角速度 传感器 MPU6050、 温 度 传感器 LM75 
等 ; 树 莓 派 通过 12C 接 口 和 SPI 接 口 ， 还 可 以 扩充 A/D 转 换 世 片 ， 树 芝 派 可 通过 A/D 转 换 世 片 连接 各 种 模拟 量 传感器 ， 如 甲烷 传感器 等 。 可 以 说 ， 树 莓 派 GPIO 扩 展 接 口 是 树 莓 派 与 物理 世界 的 一 个 桥梁 。 


1. 接 口 定 义 


表 2-2 详 细 说 明了 树 莓 派 GPIO 扩 展 接 口 的 各 引 脚 功能 。 


表 2-2 GPIO 扩 展 接 口 说 明 


TIE TII 
GND GPIOO07 / SPI CE1 
GND GPIOO5 

14 GND GND 

20 GND GPIO21 


oco |-|[Q09|t|2»|[uI|t2 


2. 编 号 方式 


为 了 更 好 地 控制 树 莓 派 扩展 接口 ， 树 长 派 爱好 者 开发 了 各 种 计算 机 语言 的 扩展 库 ， 如 使 用 Python 语言 开发 的 RPi.GPIO 扩 展 库 ， 使 用 C 语 言 开 发 的 WiringPi 扩 展 库 等 。 这 些 扩展 库 屏 蔽 了 Linux 相 关 驱 动 
的 实现 细节 ， 用 户 并 不 需要 熟悉 Linux 驱 动 相关 的 知识 也 可 以 非常 方便 地 控制 树 莓 派 CPIO。 这 些 扩展 库 功 能 相似 ， 但 是 却 使 用 了 不 同 的 编号 策略 。 一 般 情况 下 ， 树 莓 派 的 引 脚 编号 方式 包括 插座 引 脚 编号 方 
式 、BCM28XX 编 号 方式 和 WiringPi 编 号 方式 : 


: 插座 引 脚 编号 方式 : 编号 方式 侧重 扩展 插座 引 脚 编号 ， 从 上 到 下 、 从 左 到 右 依次 排列 。 这 种 编号 方式 最 为 简单 直接 。 


BCM28XX 编 号 方式 : 编号 方式 侧重 BCM28XX 寄 存 器 ， 这 种 编号 方式 根据 BCM2835 的 GPIO 寄 存 器 进行 编号 。 在 表 2-2 中 ， 引 脚 编号 为 11 的 端口 对 应 BCM28XX GPIO17 寄 存 器 ， 若 采用 BCM28XX 编 号 方 


式 ， 该 端口 的 编号 将 使 用 17。 
. WiringPi 编 号 方式 :编号 方式 侧重 逻辑 实现 ， 这 种 编号 方式 把 仅 具 有 普通 IO 功 能 的 端口 从 0 开始 重新 编号 ， 这 种 编号 方式 更 利于 代码 编写 。 表 2-3 可 以 很 好 地 反映 这 三 种 不 同 编号 方式 的 区 别 与 联系 。 


表 2-3 三 种 不 同 编号 方式 对 应 关系 


WiringPi 编号 BCM28XX 编号 


24 ”本章 小 结 


Arduino 和 树 荐 派 。 在 2.2 节 重点 介绍 了 Arduino UNO feArduino 101 两 款 型 号 ，Arduino UNO 是 Arduino 领 域 的 入 门 级 开发 板 ， 其 采用 Atmega 系 列 MCU; 而 


本 章 介 绍 了 物 联网 领域 中 常用 的 两 种 开源 硬件 
Arduino 101 是 Arduino 领 域 的 最 新 型 号 ， 采 用 Intel 世 片 组 并 集成 了 低 功 耗 蓝 牙 和 6 轴 传 感 器 功能 。 在 2.3 节 重点 介绍 了 树 著 派 2 代 B 型 和 3 代 B 型 两 种 型 号 ， 树 基 派 3 代 B 型 较 2 代 B 型 在 整体 性 能 上 有 所 提升 ， 并 集成 
了 无 线 WiFi 网 络 和 低 功 耗 蓝 牙 功能 。 


无 论 是 Arduino 还 是 树 荐 派 ， 均 需要 通过 外 部 扩展 接口 与 真实 的 物理 世界 产生 联系 ，Arduino 和 树 荐 派 均 具 有 标准 的 外 部 扩展 接口 ， 也 就 是 说 不 同型 号 之 间 虽 然 性 能 存在 差异 但 硬件 连接 方式 却 完 全 一 致 。 
这 种 标准 化 方式 使 得 市 面 上 出 现 了 大 量 的 Atduino 或 树 莓 派 扩展 板 ， 这 些 扩展 板 集成 了 各 种 各 桩 的 传感器 和 执行 设备 ， 这 些 外 部 配套 设备 也 促进 了 Arduino 和 树 芽 派 的 流行 。 


第 3 章 ”网 络 技术 回顾 


3.1 本章 主要 内 容 


本 章 我 们 将 回顾 与 CoAP 相 关 的 网 络 技术 ， 从 CoAP 的 历史 发 展 轨 人 迹 可 以 发 现 ，CoAP 并 不 是 凭空 产生 的 ， 也 并 不 是 完全 独立 设计 ， 而 是 充分 吸收 其 他 协议 的 使 用 经 验 ， 针 对 受 限 制 低 功 耗 设 备 的 特 
点 “ 量 身 定制 ”的 应 用 层 协 议 。 本 章 将 介绍 CoAP 的 “兄弟 姐妹 ”一 一 IPv4、IPv6、UDP、TCP 和 HTTP。 现 代 网 络 一 般 采 用 分 层 结构 设计 ， 若 参考 OSI 标 准 模 型 从 上 至 下 依次 为 应 用 层 、 表 示 层 、 会 话 层 、 
传输 层 、 网 络 层 、 数 据 链 路 层 和 物理 层 。 通 常 来 说 ，1Pv4 和 1Pv6 属 于 网 络 层 协议 ，UDP 和 TCP 属 于 传输 层 协 议 ，CoAP 和 HTTP 属 于 应 用 层 协议 。 图 3-1 可 以 简单 直接 地 展现 CoAP 和 其 他 协议 间 的 关系 。 


学 习 CoAP 需 要 了 解 较 多 的 Web 应 用 方面 的 基础 知识 。 如 果 读 者 还 不 熟悉 如 何 使 用 TCP 或 UDP 的 话 ， 建 议 动手 党 试 本 章 的 相关 示例 。 如 果 读 者 已 经 熟练 掌握 Web 前 端 开 发 或 者 后 端 开 发 的 话 ， 那 么 CoAP 
学 习 曲 线 将 变 得 相对 平坦 ， 所 以 这 些 读 者 可 以 完全 忽略 本 章 内 容 ; 如 果 读 者 对 HTTP CET 方 法 或 POST 方法 还 没有 任何 概念 的 话 ， 那 么 学 习 CoAP 的 曲线 将 变 得 相对 陡峭 ， 所 以 强烈 建议 这 些 读 者 动手 党 试 本 


ii 应 用 层 
i 传输 层 


IPv4/IPv6 ”网 络 层 


章 示 例 。 


图 3-1 CoAP 的 “兄弟 姐妹 ” 


本 章 将 通过 动手 尝试 的 方式 帮助 读者 复习 IP、TCP、UDP 和 HTTP 相 关 网 络 知识 。 在 3.2 节 中 ， 将 通过 ping 命 令 访 问 不 同 的 服务 器 ， 通 过 这 种 简单 的 方法 回顾 IPv4 地 址 、IPv6 地 址 、IPv4 首 部 和 IPv6 首 部 
等 基础 知识 ; 在 3.3 节 ， 将 通过 一 个 UDP Echo 示 例 回顾 UDP 首 部 和 UDP 端 口号 等 概念 ; 在 3.4 节 依然 通过 一 个 TCP Echo 示 例 回顾 TCP 首 部 和 TCP 工 作 流 程 等 内 容 ; 在 3.5 节 ， 将 通过 一 个 示例 网 页 回顾 HTTP 
方法 、HTTP 首 部 、HTTP 响 应 和 HTTP 媒 体 类 型 等 内 容 。 


除了 3.2 节 ， 其 他 所 有 小 节 均 有 服务 器 和 客户 端 两 个 角色 ， 在 相关 章节 的 示例 中 ， 服 务 器 的 程序 均 运 行 于 树 莓 派 中 ， 而 客户 端的 程序 均 运 行 于 Windows 主 机 中 。 为 了 更 好 地 分 析 IP、UDP、TCP 和 
HTTP， 需 要 在 Windows 主 机 中 安装 较 新 版 本 的 Wireshark， 通 过 抓 取 树 莓 派 和 Windows 主 机 之 间 的 网 络 分 组 数据 分 析 相 天 协议 的 实现 细节 。 


第 3 章 ”网 络 技术 回顾 


3.1 ”本章 主 要 内 容 


本 章 我 们 将 回顾 与 CoAP 相 关 的 网 络 技术 ， 从 CoAP 的 历史 发 展 轨迹 可 以 发 现 ，CoAP 并 不 是 凭空 产生 的 ， 也 并 不 是 完全 独立 设计 ， 而 是 充分 吸收 其 他 协议 的 使 用 经 验 ， 针 对 受 限 制 低 功 耗 设备 的 特 
点 “ 量 身 定制 ”的 应 用 层 协 议 。 本 章 将 介绍 CoAP 的 “兄弟 姐妹 ”一 一 |Pv4、IPv6、UDP、TCP 和 HTTP。 现 代 网 络 一 般 采 用 分 层 结构 设计 ， 若 参考 OSI 标 准 模 型 从 上 至 下 依次 为 应 用 层 、 表 示 层 、 会 话 层 、 
传输 层 、 网 络 层 、 数 据 链 路 层 和 物理 层 。 通 常 来 说 ，1Pv4 和 1Pv6 属 于 网 络 层 协议 ，UDP 和 TCP 属 于 传输 层 协 议 ，CoAP 和 HTTP 属 于 应 用 层 协议 。 图 3-1 可 以 简单 直接 地 展现 CoAP 和 其 他 协议 间 的 关系 。 


学 习 CoAP 需 要 了 解 较 多 的 Web 应 用 方面 的 基础 知识 。 如 果 读 者 还 不 熟悉 如 何 使 用 TCP 或 UDP 的 话 ， 建 议 动手 党 试 本 章 的 相关 示例 。 如 果 读 者 已 经 熟练 掌握 Web 前端 开发 或 者 后 端 开发 的 话 ， 那 么 CoAP 
学 习 曲 线 将 变 得 相对 平坦 ， 所 以 这 些 读 者 可 以 完全 忽略 本 章 内 容 ; 如 果 读 者 对 HTTP CET 方 法 或 POST 方法 还 没有 任何 概念 的 话 ， 那 么 学 习 CoAP 的 曲线 将 变 得 相对 陡峭 ， 所 以 强烈 建议 这 些 读 者 动手 党 试 本 


章 示 例 。 


HTTP 应 用 层 


TCP i zy Ez 


图 3-1 CoAP 的 “兄弟 姐妹 ” 


本 章 将 通过 动手 党 试 的 方式 帮助 读者 复习 IP、TCP、UDP 和 HTTP 相 关 网 络 知识 。 在 3.2 节 中 ， 将 通过 ping 命 令 访问 不 同 的 服务 器 ， 通 过 这 种 简单 的 方法 回顾 IPv4 地 址 、1Pv6 地 址 、1Pv4 首 部 和 1IPv6 首 部 
等 基础 知识 ; 在 3.3 节 ， 将 通过 一 个 UDP Echo 示例 回顾 UDP 首部 和 UDP 端口 号 等 概念 ;在 3.4 节 依然 通过 一 个 TCP Echo 示例 回顾 TCP 首 部 和 TCP 工 作 流程 等 内 容 ; 在 3.5 节 ， 将 通过 一 个 示例 网 页 回顾 HTTP 
方法 、HTTP 首 部 、HTTP 响 应 和 HTTP 媒 体 类 型 等 内 容 。 


除了 3.2 节 ， 其 他 所 有 小 节 均 有 服务 器 和 客户 端 两 个 角色 ， 在 相关 章节 的 示例 中 ， 服 务 器 的 程序 均 运 行 于 树 莓 派 中 ， 而 客户 端的 程序 均 运 行 于 Windows 主 机 中 。 为 了 更 好 地 分 析 IP、UDP、TCP 和 
HTTP， 需 要 在 Windows 主 机 中 安装 较 新 版 本 的 Wireshark， 通 过 抓 取 树 莓 派 和 Windows 主 机 之 间 的 网 络 分 组 数据 分 析 相 关 协 议 的 实现 细节 。 


3.2 IP 


1P 是 一 种 在 源 地 址 和 目标 地 址 之 间 传 输 数 据 分 包 的 协议 ，1P 是 现代 网 络 技术 的 重要 组 成 部 分 ， 是 整个 协议 族 的 基础 ， 它 为 传输 层 协议 UDP 和 TCP 提 供 服务 。1P 分 为 |Pv4 版 本 和 1IPv6 版 本 ，1Pv4 为 人 熟知 
并 取得 了 海量 的 应 用 。 但 是 随 着 1Pv4 地 址 的 枯竭 ，1Pv6 技 术 进 入 工程 师 的 视野 。 相 比 于 IPv4 技 术 ，1Pv6 技 术 有 更 大 的 地 址 空间 、 即 插 即 用 、 更 好 的 安全 性 和 移动 性 等 特点 。 与 大 多 数 工 程 师 的 一 般 印 象 相 
反 ，IPv6 协 议 比 IPv4 协 议 更 加 简单 ， 借 助 6&LoWPAN 这 样 的 IPv6 头 压缩 技术 ，IPv6 可 以 很 好 地 在 受 限 制 低 功 耗 设备 中 使 用 ， 所 以 在 物 联网 领域 IPv6 将 有 很 好 的 前 景 。 在 本 书 第 10 章 将 展现 一 个 受 限制 低 功 耗 
设备 通过 IPv6/6LoWPAN 技 术 连 接 网 络 的 实例 。 


由 于 1Pv6 技 术 并 没有 普及 ， 从 长 远 来 看 IPv4 和 1Pv6 将 会 长 期 并 存 ， 那 么 有 必要 同时 掌握 这 两 种 技术 。 本 节 为 了 避免 教科 书 式 的 讲解 ， 将 通过 两 个 简单 的 示例 说 明 IPv4 和 1Pv6， 并 说 明 它 们 之 间 的 区 别 。 
我 们 将 使 用 ping 命 令 连 接 两 个 不 同 的 服务 器 一 一 腾讯 服务 器 (www.qq.com) 和 百度 服务 器 (www.baidu.com) ， 通 过 Wireshark 抓 取 网 络 数据 分 包 分 析 IPv4 和 1Pv6 的 相关 细节 ， 最 后 比较 I|Pv4 和 1Pv6 之 
间 的 区 别 与 联系 。 


3.2.1 动手 尝试 
本 节 将 使 用 ping 命 令 访问 www.baidu.com 和 www.qq.com，ping 命 令 一 般 用 于 测试 目标 主机 是 否 可 达 ， 在 Windows 主 机 中 使 用 ping 指 令 ，Windows 主 机 将 会 发 送 ICMP 请 求 ， 若 服务 器 收 到 ICMP 请 
求 将 会 立即 返回 ICMP 响 应 ，Windows 主 机 收 到 了 ICMP 响 应 则 说 明 目 标 服务 器 可 达 。 在 本 节 相 关 测 试 环境 中 ，www.baidu.com 仅 提供 了 IPv4 访 问 ， 而 www.qq.com 提 供 了 IPv4 和 1Pv6 访 问 能 力 。 


1. 测 试 环境 说 明 


在 本 节 示 例 中 ,测试 Windows 主 机 已 经 具备 了 IPv4 和 IPv6 访 问 能 力 ， 通 过 ipconfig 命 令 可 以 查看 本 机 IPv4 地 址 和 IPv6 地 址 ， 此 时 测试 主机 IPv4 地 址 为 100.84.243.XXX， 而 IPv6 地 址 为 240e: ec: 
4252: 5095: 2073: 3e82: 3e3: ABCD， 如 图 3-2 所 示 。 


HE www.baidu.com 腾讯 www.qq.com 
IPv43t9 TE 180.97.33.108 IPv63t Ti 240e:e1:8100:28::2:16 


ping www.baidu.com ping WWW.qq.com 


本 机 IPv4 地 址 100.84.243.XXX 
本 机 IPv6 地 址 240e:ec:4252:5095:2073:3e82:3e3:ABCD 


图 3-2 ”测试 环境 说 明 
Ož 
T 此 处 测试 主机 的 IPv4 地 址 隐 去 最 后 一 字 节 ， 采 用 XXX 代替 ; 而 测试 主机 IPv6 地 址 隐 去 最 后 两 字 节 ， 采 用 ABCD 替 代 。 


2. 尝 试 IPv4 连 接 


启动 Wireshark， 选 择 合适 的 网 卡 以 捕获 网 络 数据 。 在 过 滤器 中 输入 “icmp” 表 示 仅 显示 ICMP 请 求 和 响应 数据 分 包 。 在 Windows 主 机 中 新 建 控 制 台 并 在 控制 台中 输入 : 


ping www.baidu.com 


[ 
7 FJ 
来 自 180.97.33.108 的 回复 : 字 节 =32 时 间 =7ms TTL=56 
: 字 节 =32 时 间 =6ms TTL-56 


来 自 180.97.33.108 的 回复 : 字 节 =32 时 间 =5ms TTL-56 
c 


: 已 发 这 = 4, 已 # 
往返 行程 的 估计 时 间 (以 毫秒 为 单位 ) : 
最 短 = 5ms， 最 长 = 7ms， 平 均 = 6ms 


从 输出 结果 来 看 ， 测 试 Windows 主 机 成 功 连接 了 百度 服务 器 ， 此 时 百度 服务 器 的 IPv4 地 址 为 180.97.33.108。 在 Wireshark 中 可 以 选中 |CMP 请 求 或 响应 的 任何 一 个 数据 分 包 。 如 图 3-3 所 示 ， 此 时 IP 协 议 


的 版 本 编号 为 “Version: 4”， 源 地 址 为 “100.84.243.XXX”， 该 IPv4 地 址 为 Windows 测 试 主机 的 地 址 ， 目 标 地 址 为 “180.97.33.108”， 该 IPv4 地 址 指向 百度 某 人 服务 器 。 


示 过 滤器 中 输入 “icmpv6” 表 示 仪 显示 ICM Pv6 请 求 和 响应 数据 包 。|ICMPv6 在 IPv6 协 议 中 非常 重要 ， 它 甚至 取代 了 1Pv4 协 议 中 的 ARP 部 分 。 


0100 .... = Version: 4 
. 0101 - Header Length: 20 bytes (5) 
Differentiated Services Field: 0x00 (DSCP: CS0, ECN: Not-ECT) 
Total Length: 60 
Identification: 0x743c (29756) 
Flags: 0x00 
Fragment offset: 0 
Time to live: 128 


Protocol: ICMP (1) 


Header checksum: 0x98d9 [validation disabled] 


Source: 100.84.243. 1 8 
Destination: 180.97.33.108 


[Source GeoIP: Unknown] 


[Destination GeoIP: Unknown] 


00 eð fc bð c8 d4 50 7b 9d =E *- * 88 
39 08 00 3e 00 21 45 00 200 3c 74 3c 00 
98 d9 64 54 f3 MW b4 61 21 6c 08 00 Ad 
00 30 61 62 63 64 65 66 67 68 69 6a 6b 


Frame 30: 82 bytes on wire (656 bits), 82 bytes captured (656 bits) on interface 0 

Ethernet II, Src: LcfcHefe a0:87:8d (50:7b:9d:s* *^ $9), Dst: HuaweiTe b0:c8:d4 (00:e0:fc:b0:c8:d4) 
PPP-over-Ethernet Session 
Point-to-Point Protocol 
Internet Protocol Version 4, Src: 100.84.243.:.--, Dst: 180.97.33.108 


.Gabcdef ghijklmn 


6f 70 71 72 73 74 75 76 77 61 62 63 64 opqrstuv wabcdefg 


68 69 hi 


图 3-3 ”连接 百度 服务 器 


3. 尝 试 IPv6 连 接 


与 百度 服务 器 不 同 ， 腾 讯 服务 器 可 提供 |Pv4 和 1Pv6 两 种 访问 能 力 。 在 IPv4 和 1Pv6 两 种 访问 能 力 共存 的 情况 下 优先 使 用 IPv6 而 不 是 IPv4。 先 启动 Wireshark， 选 择 合适 的 网 卡 以 捕获 网 络 分 组 数据 ， 在 显 


在 Windows 主 机 中 新 建 控制 台 并 在 控制 台中 输入 : 


16" 


ping www.dq.com 


正在 


Ping www.qq.com [240e:e1:8100:28::2:16] 具有 32 字 节 的 数据 : 


来 自 240e:e1:8100:28::2:16 的 回复 : 时 间 =5ms 
来 自 240e:e1:8100:28::2:16 的 回复 : 时 间 =6ms 
来 自 240e:e1:8100:28::2:16 的 回复 : 时 间 =5ms 
来 自 240e:e1:8100:28::2:16 的 回复 : 时 间 =6ms 


240e:e1:8100:28::2:16 的 Ping 统计 信息 : 


4， 已 接收 = 4, ER = 0 (0% XA), 


数据 包 : 已 发 送 = 
往返 行程 的 估计 时 间 (以 毫秒 为 单位 ) : 


最 短 = 5ms， 最 长 = 6ms， 平 均 = 5ms 


从 输出 结果 来 看 ， 测 试 Windows 主 机 成 功 连 接 了 腾讯 服务 器 ， 此 时 腾讯 服务 器 的 IPv6 地 址 为 240e: e1: 8100: 28: : 2: 16。 在 Wireshark 中 可 选中 ICM Pv6 请 求 或 响应 的 任何 一 个 数据 分 包 。 如 图 3- 
4 所 示 ， 此 时 IP 的 版 本 编号 为 “Version: 6”， 源 地 址 为 “240e: ec: 4252: 5095: 2073: 3e82: 3e3: ABCD" , 该 IPv6 地 址 为 Windows 测 试 主机 的 地 址 ， 目 标 地 址 为 “240e: e1: 8100: 28: : 2: 
， 该 IPv6 地 址 指向 腾讯 服务 器 。 


Frame 46: 102 bytes on wire (816 bits), 102 bytes captured (816 bits) on interface 0 
Ethernet II, Src: LcfcHefe a0:87:8d (50:7b:9d:9* *^ 9»), Dst: HuaweiTe b0:c8:d4 (00:e0:fc:b0:c8:d4) 
PPP-over-Ethernet Session 
Point-to-Point Protocol 
Internet Protocol Version 6, Src: 240e:ec:4252:5095:2073:3e82:3e3:1 * 4, Dst: 240e:e1:8100:28: :2:16 
0110 .... = Version: 6 
. 0000 0000 .... .... .... .... .... = Traffic class: 0x00 (DSCP: CSO, ECN: Not-ECT) 
—s" . 0000 0000 0000 0000 0000 - Flowlabel: 0x00000000 
Payload length: 40 
Next header: ICMPv6 (58) 
Hop limit: 128 
Source: 240e:ec:4252:5095:2073:3e82:3e3:3 238 
Destination: 240e:e1:8100:28::2:16 
[Source GeoIP: Unknown] 
[Destination GeoIP: Unknown] 
> Internet Control Message Protocol v6 


m 88 64 11 00 
28 3a 80 24 0e EV. . ...(:. 
e3 24 0e m 4 6-5 aoa 


66 67 68 69 6a ab cdefghij 
76 77 61 62 63 klmnopqr stuvwabc 
defghi 


图 3-4 连接 腾讯 服务 器 


通过 示例 可 以 说 明 ， 在 当前 网 络 中 IPv4 和 1IPv6 正 在 被 同时 使 用 ， 无 论 是 IPv4 还 是 IPv6 都 在 发 挥 着 自身 的 作用 。 但 是 随 着 物 联 网 设备 的 普及 ，1Pv6 将 会 发 挥 越 来 越 多 的 作用 。 如 果 不 熟 悉 I|Pv6 也 没有 关 
系 ， 市面 上 已 经 有 不 少 关 于 IPv6 的 图 书 资料 ， 通 过 阅读 资料 并 通过 Wireshark 做 些 网 络 分 析 实 验 ， 也 可 以 很 快 掌握 IPv6 的 相关 知识 。 经 过 简单 的 动手 尝试 之 后 我 们 将 回顾 IPv4 和 和 IPv6 的 基础 知识 。 


3.2.2 ”1Pv4 首 部 


IPv4 首 部 如 图 3-5 所 示 ，1Pv4 各 字段 的 含义 说 明 如 下 : 
“版 本 (4 位 ) : 该 字段 表示 IP 协 议 的 具体 版 本 ， 对 于 IPv4 来 说 该 值 固定 为 0x04。 


. 首部 长 度 (ME) : 此 处 的 首部 长 度 包含 了 首部 选项 与 填充 部 分 ， 并 且 以 32 位 (4 字 节 ) 为 最 小 单位 。 如 果 没 有 首部 选项 和 填充 部 分 ， 那 么 该 字段 的 值 固定 为 0x05， 也 就 是 说 IPv4 的 首部 长 度 为 20 字 


=} 


RIXA: 表示 所 和 希望 的 服务 质量 。 该 字段 在 IPv4 中 并 不 常用 。 

. 总 长 度 : 表示 IP 数 据 包 的 总 长 度 。 该 字段 占 2 字 节 ， 也 就 是 说 单个 IP 数 据 包 的 最 大 长 度 为 65536 字 节 。 

. 标识 : 在 IP 分 片 中 使 用 ， 同 一 个 IP 数 据 包 的 所 有 分 片 具有 相同 的 标识 编号 。 

. 标志 (ME) : 同样 在 IP 分 片 中 使 用 。 

* 分 片 偏 移 (13 位 ) : 同样 在 IP 分 片 中 使 用 ， 标 识 该 分 片 在 原始 报 文 中 的 位 置 ， 分 片 偏 移 以 8 字 节 为 最 小 单位 ， 所 以 需要 将 该 值 乘 以 8 才 可 以 获得 原来 的 位 置 。 
- 生存 时 间 : 用 于 防止 数据 包 在 路 由 器 之 间 无 限期 的 流动 。 每 经 过 一 个 路 由 器 该 值 递减 1。 如 果 该 值 减 至 0， 该 数据 包 将 被 路 由 器 丢弃 。 

HR: 表示 IP 负 载 中 的 协议 类 型 。 例 如 ， 协 议 值 为 1 表示 IP 负 载 为 ICMP 协 议 ， 协 议 值 为 6 表示 也 负 载 为 TCP 协 议 ， 协 议 值 为 17 表 示 IP 负 载 为 UDP 协议 。 
. 首部 校 验 : 对 于 IP 首 部 计算 的 16 位 校 验 和 。 

| 源 地 址 : 创建 该 PP 数据 分 包 的 设备 的 32 位 IP 地 址 。 

|: 目标 地 址 : 该 IP 数 据 分 包 的 接收 设备 的 32 位 IP 地 址 。 

. 选项 : 长 度 可 变 ， 通 常用 于 实验 与 诊断 。 该 字段 包含 安全 级 别 、 源 路 径 、 路 径 记 录 和 时 间 堆 等 信息 。 

AR: 如 果 包 括 选项 部 分 ， 那 么 选项 部 分 的 长 度 必须 是 32 位 (4578). 的 整数 倍 ， 否 则 需要 使 用 填充 部 分 。 


1Pv4 首 部 包含 的 内 容 较 多 ， 但 在 实际 的 开发 过 程 中 只 需要 天 注 |P 协 议 版 本 号 、 源 地 址 和 目标 地 址 即 可 。 对 于 IP 分 片 和 重组 等 较为 复杂 的 部 分 ， 操 作 系 统 内 的 网 络 协议 栈 已 经 为 用 户 进行 处 理 ， 在 开发 过 
程 中 工程 师 并 不 需要 关心 。 
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图 3-5 IPv4 首 部 


3.2.3 1Pv4 地 址 


在 设备 间 进 行 网 络 通信 时 ， 使 用 IP 地 址 识别 主机 和 路 由 器 。 为 了 保证 设备 间 的 正常 通信 ， 每 个 设备 都 应 有 正确 的 |P 地 址 。IPv4 地 址 由 32 位 正 整数 表示 。IP 地 址 在 计算 机 或 嵌入 式 系 统 内 部 总 是 以 二 进 制 
形式 保存 ， 但 是 人 们 总 是 不 习惯 于 阅读 和 使 用 二 进 制 方式 ， 所 以 IPv4 地 址 把 32 位 IPv4 地 址 分 成 8 位 一 组 ， 共 分 成 4 组 ， 各 组 之 间 通 过 “.” 隔 开 ， 每 组 通过 十 进 制 表 示 。192.168.1.100 便 是 一 个 合法 的 IPv4 地 
址 。 


1. 网 络 ID 和 主机 ID 


IPv4 地 址 一 般 由 网 络 ID 和 主机 1D 两 部 分 组 成 。 网 络 ID 在 数据 链 路 的 每 个 段 将 配置 不 同 的 值 ， 网 络 ID 必须 保证 相互 连接 的 每 个 段 的 地 址 不 重复 。 而 相同 段 内 的 主机 必须 具有 相同 的 网 络 标识 。 这 种 结构 非 
常 有 利于 路 由 器 的 工作 ， 路 由 器 可 以 很 容易 地 知道 目标 主机 发 送 的 数据 在 同一 个 网 络 中 还 是 在 不 同 的 网 络 中 ， 路 由 器 可 以 通过 比较 两 个 IP 地 址 的 网 络 ID 便 可 做 出 决策 。 


网 络 ID 和 主机 ID 的 表示 方式 有 两 种 : 后 缀 法 和 子 网 掩 码 法 。 例 如 192.168.1.100/24，24 表 示 网 络 ID 占 该 1Pv4 地 址 的 前 24 位 ， 此 时 网 络 ID 为 192.168.1.0，1Pv4 地 址 共 32 位 ， 那 么 剩余 的 8 位 便 是 主机 ID， 
所 以 此 时 的 主机 1D 为 0.0.0.100。 除 了 后 缀 表示 法 之 外 ， 子 网 掩 码 法 也 非常 常用 ， 子 网 掩 码 的 长 度 和 1Pv4 地 址 的 长 度 相 同 ， 若 某 位 为 比特 0 表示 该 位 留 给 网 络 ID， 如 果 该 位 为 比特 1， 表 示 该 位 留 给 主机 ID。 如 
果 1Pv4 地 址 192.168.1.100 的 子 网 掩 码 为 255.255.255.0， 那 么 它 的 网 络 ID 为 192.168.1.0， 主 机 ID 为 0.0.0.100。1Pv4 采 用 网 络 ID 和 主机 ID “混合 排版 ”的 方式 ， 而 IPv6 改 变 了 这 种 方式 ， 把 网 络 ID 和 主机 1D 完 
全 分 离 。 图 3-6 可 以 非常 直观 地 解释 |P 地 址 中 网 络 ID 和 主机 ID 的 关系 。 
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图 3-6 ”IPv4 地 址 说 明 


2. 私 有 IPv4 地 址 


通过 前 面 几 个 章节 可 以 获知 ， 若 物 联网 设备 连接 网 络 将 会 消耗 大 量 的 IP 地 址 ， 但 是 未 等 物 联网 普及 ，IPv4 地 址 已 经 不 能 满足 个 人 计算 机 和 移动 手机 的 需求 ，IPv4 地 址 已 经 枯竭 。 为 了 解决 这 种 需求 冲突 
出 现 了 多 种 新 技术 ， 其 中 就 包括 私有 IPv4 地 址 和 NAT 技 术 ， 通 过 这 两 项 技术 可 使 联网 设备 并 不 需要 全 局 唯一 的 |Pv4 地 址 ， 仅 需要 在 同一 个 域 中 保持 唯一 便 可 。 虽 然 私 有 IPv4 地 址 和 NAT 技 术 非 常 普 及 ， 但 是 
该 技术 并 不 利于 物 联网 设备 的 发 展 。 


3.2.4 IPv6E3ED 


IPv6 首 部 较 IPv4 首 部 发 生 了 巨大 的 变化 ， 但 是 这 种 变化 并 没有 使 iP 变 得 更 复杂 ， 反 而 使 IPv6 显 得 更 简单 一 些 。IPv6 首 部 如 图 3-7 所 示 。 
IPv6 首 部 包含 以 下 内 容 : 
` 版 本 (4 位 ) : 表示 IP 的 版 本 号 ， 此 处 该 字段 为 固定 值 0x06。 


` 流量 类 别 : 该 字段 与 IPv4 中 的 服务 类 型 比较 相似 ， 由 于 服务 类 型 在 IPv4 领 域 中 并 没有 发 挥 实际 的 作用 ， 所 以 原 计 划 在 IPv6 中 删除 该 部 分 ， 但 是 出 于 兼容 和 其 他 方面 的 考虑 最 后 还 是 在 IPv6 中 保留 了 该 


| 流标 签 (20 位 ) : 流标 签字 段 用 于 记录 从 源 节 点 发 送 至 多 个 目标 节点 的 一 系列 IPv6 数 据 包 的 序列 ， 源 节点 可 以 利用 该 字段 标志 那些 请 求 ITPv6 路 由 器 进行 特殊 处 理 的 数据 包 序 列 。 流 标签 可 以 标识 同一 
个 流 中 的 所 有 数据 包 ， 从 而 保证 所 有 的 数据 包 都 可 以 得 到 IPv6 路 由 器 的 相同 处 理 。 
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图 3-7 IPv6 首 部 


AREKE: 该 字段 表示 IPv6 首 部 之 后 的 负载 长 度 。 如 果 IPv6 数 据 包 有 一 个 或 多 个 扩展 头 ， 那 么 该 字段 也 包括 这 些 扩展 头 的 长 度 。IPv6 的 净 载 荷 长 度 和 IPv4 的 数据 包 总 长 度 存在 明显 区 别 。IPv4 的 数 
据 包 总 长 度 包 括 IPv4 首 部 和 IPv4 负 载 ， 而 IPv6 净 载荷 长 度 为 IPv6 的 有 效 负载 的 长 度 。 换 和 句 话说 ，IPv6 的 首部 长 度 并 不 需要 指示 ， 它 的 长 度 总 是 为 40 字 节 。 


* 下 一 个 首部 : 下 一 个 首部 有 两 个 作用 ， 如 果 IPv6 数 据 包 只 有 基本 首部 而 没有 扩展 首部 的 话 ， 那 么 下 一 个 首部 就 是 表示 IPv6 负 载 中 所 承载 的 协议 ， 这 一 点 与 1Pv4 中 的 协议 类 型 字段 非常 相似 ， 而 且 该 字 
段 与 IPv4 首 部 中 的 协议 类 型 使 用 相同 的 协议 值 ， 如 下 一 个 首部 取 值 为 6 时 表示 IPv6 负 载 为 TCP 协 议 ， 取 值 为 17 时 表示 IPv6 负 载 为 UDP 协议 ， 取 值 为 58 时 表示 IPv6 负 载 为 TCMPv6 协 议 。 图 3-8 很 好 地 解释 了 下 一 
个 首部 和 IPv6 负 载 之 间 的 关系 。 


` 跳 数 限制 : 跳 数 限制 字段 与 IPv4 首 部 中 的 生存 时 间 非 常 类 似 。 该 字段 的 值 每 经 过 一 个 路 由 器 便 递 减 1。 


- 源 地 址 : IPv6 数 据 包 发 起 设备 的 128 位 IPv6 地 址 。 


| 目标 地 址 : 该 IPv6 数 据 包 的 预计 接收 设备 的 128 位 IPv6 地 址 。 与 IPv4 不 同 ，IPv6 并 没有 广播 地 址 ， 取 而 代 之 的 是 IPv6 组 播 地 址 。 


图 3-8 ”IPv6 下 一 个 首部 


IPv4 和 1Pv6 的 最 显著 区 别 便 是 IPv4 地 址 为 32 位 ， 而 IPv6 地 址 一 下 子 增加 到 128 位 。 


3.2.5 ”IPv6 地 址 

1Pv6 地 址 一 般 采 用 x: X: x: x: X: x: x: x 格式 。 每 个 x 都 是 一 个 16 位 数 ， 可 使 用 4 个 十 六 进 制 数字 来 表示 ， 每 个 x 之 间 采 用 冒号 卫 开 。 所 以 IPv6 地 址 包含 了 8 个 16 位 区 域 ， 一 共 为 128 位 ， 如 2020: 
CA28: 0000: 0000: 0023: 0222: 0000: 2900, 

这 样 的 |Pv6 地 址 实在 太 长 了 ， 所 以 非常 有 必要 简化 1Pv6 的 写法 。1Pv6 的 简化 写法 可 遵循 两 条 规则 一 一 省 略 前 导 0 和 省 略 全 0， 如 图 3-9 所 示 。 

1. 省 略 前 导 0 

所 有 16 位 数 中 的 前 导 0 都 可 以 被 省 略 ， 请 注意 该 规则 只 适用 于 前 导 0， 而 尾部 的 0 绝 不 能 被 省 略 。 那 么 2020: CA28: 0000: 0000: 0023: 0222: 0000: 2900 将 可 以 简化 为 : 

2020: CA28: 0: 0: 23: 222: 0: 2900 

2. 省 略 全 0 


在 IPv6 地 址 定义 中 可 使 用 双 冒 号 (: : ) 表示 任意 一 段 连续 的 由 一 个 或 者 多 个 全 零 组 成 的 16 位 数 ， 采 用 这 样 的 方法 可 以 进一步 简化 IPv6 地 址 。 那 么 IPv6 地 址 2020: CA28: 0: 0: 23: 222: 0: 2900 可 
以 进一步 简化 为 : 


2020: CA28: : 23: 222: 0: 2900 


无 论 是 IPv4 还 是 IPv6 都 是 学 习 CoAP 之 前 需要 掌握 的 基础 内 容 ， 由 于 本 书 篇 幅 有 限 无 法 详细 展开 ， 更 多 的 内 容 请 参考 《IPv6 技 术 精 要 》 和 《深入 解析 IPv6 (第 三 版 ) 》 等 书 。 
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图 3-9 ”IPv6 地 址 省 略 写 法 


3.8 UDP 


虽然 iP 在 互联 网 和 物 联网 领域 中 非常 重要 ， 但 是 IP 本 身 并 不 能 组 成 一 个 完整 应 用 ，1IP 协 议 必须 与 其 他 协议 一 起 才 可 以 构成 一 个 独立 的 应 用 。UDP 和 TCP 正 是 被 广泛 使 用 的 传输 层 协 议 ， 下 面 我 们 结合 
个 具体 的 例子 介绍 UDP 和 TCP。 


UDP 是 User Datagram Protocal 的 简称 ， 可 以 翻译 为 用 户 数据 协议 。UDP 为 那些 需 


更 上 一 层 协 议 实现 。CoAP 正 是 采用 UDP 作 为 传输 层 协 议 ， 所 以 学 习 CoAP 之 前 必须 要 了 解 UDP 的 相关 细节 。 


3.3.1 动手 尝试 


简单 且 快 速 的 传输 层 协议 的 应 用 而 设计 。UDP 非 常 简单 ， 仪 包括 了 端口 和 IP 地 址 等 音 


pg 分， 而 把 其 他 的 工作 都 交 给 


本 节 通 过 一 个 示例 展现 UDP 工作 的 大 概 流程 。 在 这 个 动手 示例 中 有 两 个 角色 一 一 UDP 客户 端 和 UDP 服务 器 ，UDP 客 户 端 可 由 Windows 主 机 实现 ， 而 UDP 服务 器 由 树 莓 派 实 现 ，UDP 客 户 端 和 服务 器 端 


代码 均 使 用 Python 编写 。 


1. 获 取代 码 
可 通过 Git 工 具 复制 本 书 提 供 的 示例 代码 。 


# 新 建 一 个 名 为 repo 的 文件 夹 
mkdir -p repo 
# _ clone 代码 仓库 
git D https://github.com/xukai871105/the beginning of coap.git 
* 进 
cd the beginning of 
# MEA MAER IRIRI Sce 
cd review demo 

# 进入 udp 示 例 目录 


cd udp echo demo 


2.UDP 服 务 器 实现 


UDP 服务 器 和 UDP 客户 端 均 使 用 Python 3 编写 ， 示 例 代码 中 使 用 了 Python 3.4 之 后 自 带 的 异 


udp_server.py 的 具体 代码 如 下 : 


代码 清单 3-1 udp server.py 


import asyncio 


class EchoServerProtocol: 
def connection made(self, transport): 
self.transport = transport 


def datagram received(self, data, addr): 

message = data.decode|() 

print('Received $r from $s' $ (message, addr)) 
print('Send $r to $s' $ (message, addr)) 
self.transport.sendto(data, addr) 


loop = asyncio.get event loop() 

print("Starting UDP server") 

listen = loop.create datagram endpoint( 
EchoServerProtocol, local addr-('0.0.0.0', 5683)) 
transport, protocol - loop.run until complete (listen) 


try: 

loop.run forever () 
except KeyboardInterrupt: 
pass 


transport.close|() 
loop.close|() 


udp server.pySz3l f —/ (5j EBBRSUDPREÓOSSS, BOSSRTSHU SS Fit sa 


(1) 创建 服务 器 


全 它 的 内 容 原样 返回 至 客户 端 。 


步 1O 处 理 框架 asyncio， 相 比 于 传统 的 socket，asyncio 可 以 更 方便 地 完成 网 络 应 用 开发 。 


通过 create _datagram_endpoint 方 法 创建 一 个 UDP 服务 器 ， 该 方法 传 入 两 个 参数 : Echo-ServerProtoco| 为 一 个 协议 实例 ， 该 实例 中 包含 多 个 回调 函数 ， 用 于 处 理 建 立 连接 、 接 收 数据 处 理 等 事件 ; 


local_addr 用 于 绑 定 IP 地 址 和 端口 号 ，'0.0.0.0' 表 示 侦 听 本 机 的 所 有 了 网卡，5683 为 侦 听 端口 号 ，5683 正 是 CoAP 协 议 的 “知名 


listen = = loop.create datagram endpoint ( 
EchoServerProtocol, local addr-('0.0.0.0', 5683)) 


(2) 接收 数据 处 理 


在 EchoServerProtocol 中 ， 一 旦 UDP 服务 器 接收 到 网 络 数据 ， 那 么 将 会 


回 至 客户 端 。 


class EchoServerProtocol: 
# 省 略 部 分 代码 
def datagram received(self, data, addr): 
message = data.decode() 
print('Received $r from $s' $ (message, addr)) 
print('Send $r to $s' $ (message, addr)) 
self.transport.sendto (data, addr) 


3.UDP 客 户 端 实现 


进入 datagram _ received 回 调 函 数 ， 在 该 回调 函数 中 通 
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UDP 客户 端的 代码 和 UDP 服务 器 非常 相似 ， 读 者 运行 该 示例 之 前 需要 修改 代码 中 的 raspberry_ip_addrss 变 量 ， 并 把 该 变量 蔡 换 为 树 莓 派 的 实际 I|P 地 址 。 


udp_client.py 的 具体 代码 如 下 : 


过 data.decode 获 取 客 户 端 请 求 内 容 


了 


最 后 通过 transport.sendto 原 样 返 


代码 清单 3-2 udp client.py 


import asyncio 
f replace ip address 


raspberry ip addrss = '192.168.0.8' 
class EchoClientProtocol: 
def init (self, message, loop): 
self.message = message 
self.loop = loop 
self.transport - None 
def connection made(self, transport): 
self.transport = transport 
print('Send:', self.message) 
self.transport.sendto (self.message.encode()) 


def datagram received(self, data, addr): 
print ("Received:", data.decode|()) 


print("Close the socket") 
self.transport.close|() 


def error received(self, exc): 
print('Error received:', exc) 


def connection lost(self, exc): 

print("Socket closed, stop the event loop") 
loop = asyncio.get event loop() 
loop.stop() 


loop = asyncio.get event loop() 
message = "Hello World!" 
connect = loop.create datagram endpoint ( 
lambda: EchoClientProtocol (message, loop), 
remote addr-(raspberry ip addrss, 5683)) 
transport, protocol = loop.run until complete (connect) 
loop.run forever () 
transport.close() 
loop.close() 


udp_client.py 实 现 了 客户 端的 所 有 功能 ， 一 旦 客户 端 和 服务 器 建立 连接 ，udp_client 便 把 “Hello World! ”字符 串 发 送 至 UDP 服务 器 ， 若 udp_client 接 收 到 服务 器 返回 的 数据 则 把 返回 内 容 打印 至 控 
制 台 ， 关 闭 连接 并 最 终结 束 程序 。 


(1) 创建 UDP 客户 端 


通过 create datagram_endpoint 方 法 创建 UDP 客户 端 ， 该 方法 传 入 两 个 参数 : EchoClient-Protocol (message, loop) 为 一 个 协议 示例 ， 该 实例 处 理 网 络 连接 、 连 接 丢 失 和 接收 数据 等 事件 ; 
remote addr- (raspberry ip addrss, 5683) 用 于 指定 目标 服务 器 地 址 和 端口 号 ， 此 处 目标 服务 器 为 树 莓 派 IP 地 址 ， 端 口号 为 5683。 
connect = loop.create datagram endpoint( 


lambda: EchoClientProtocol (message, loop), 
remote addr= (raspberry ip addrss, 5683)) 


(2) &3X€ "Hello World! " 


通过 transport.sendto (message.encode () ) 把 “Hello World! ”发 送 至 服务 器 端 。 


class EchoClientProtocol: 
OBRCETHATU 
def connection made(self, transport): 
self.transport = transport 
print('Send:', self.message) 
self.transport.sendto (self.message.encode()) 


(3) 打印 接收 数据 


一 旦 接收 到 服务 器 返回 的 数据 ， 那 么 将 进入 datagram_received 回 调 函 数 ，data.decode () 中 便 是 服务 器 返回 的 “Hello World! ”， 打 印 服 务 器 返回 的 数据 后 关闭 UDP 连 接 。 


class EchoClientProtocol: 
# 省 略 若 干 代码 
def datagram received(self, data, addr): 
print ("Received:", data.decode|()) 
print("Close the socket") 
self.transport.close|() 


4 执行 示例 代码 


在 树 莓 派 控 制 人 台中 输入 : 


Python3 udp server.py 


在 Windows 控 制 台 中 输入 : 


python3 udp client.py 


树 莓 派 控制 台 输出 以 下 类 似 内 容 : 


Starting UDP server 
Received 'Hello World!' from ('192.168.0.3', 53495) 
Send 'Hello World!' to ('192.168.0.3', 53495) 


Windows 控 制 台 输出 以 下 类 似 内 容 : 


Send: Hello World! 

Received: Hello World! 

Close the socket 

Socket closed, stop the event loop 


3.3.8. UDP 和 首部 


通过 运行 示例 代码 可 以 发 现 : 两 个 设备 若 需 要 通过 UDP 传输 数据 ，UDP 客 户 端 需要 知晓 服务 器 的 |P 地 址 和 服务 端口 号 ，1P 首 部 中 已 经 定义 了 源 I|P 地 址 和 目标 |P 地 址 ， 那 么 UDP 就 需要 定义 源 端 口号 和 有 目 
标 端口 号 。UDP 首 部 如 图 3-10 所 示 。 


0 o 16 24 32 


目标 端口 号 


六 用 数据 


图 3-10 ”UDP 首 部 结构 
相 比 于 TCP 首 部 ，UDP 首 部 显得 异常 简单 ，UDP 首 部 仪 包括 源 端口 号 、 目 标 端口 号 、 长 度 和 校 验 和 。 
“ 源 端 口号 〈2 字 节 ) : 表示 发 送 进程 的 16 位 端口 号 。 
| 目标 端口 号 〈2 字 节 ) : 表示 接收 进程 的 16 位 端口 号 。 
DOR (2 字 节 ) : 整个 UDP 数据 包 的 长 度 ， 包 含 UDP 首部 和 应 用 数据 。 
. 校 验 和 (2 字 节 ) : 可 选项 ， 包 括 IP 首 部 中 的 源 地 址 与 目标 IP 地 址 、UDP 首 部 。 


- 应 用 数据 : UDP 负载 数据 ， 整 个 CoAP 数 据 分 包 可 作为 UDP 的 应 用 数据 。 


3.3.3 UDP 示例 分 析 


1.IP 为 UPD 提 供 服 务 

现代 网 络 采 用 分 层 设 计 ， 一 般 下 层 协议 为 上 层 协 议 提 供 服务 ， 对 于 UDP 来 说 ，IP 是 它 的 下 层 协议 ，1P 为 UDP 提供 源 I1P 地 址 和 目标 IP 地 址 等 信息 ， 并 把 整个 UDP 数据 分 包 作 为 |P 数 据 分 包 的 负载 。 当 然 
UDP 也 可 以 为 其 他 协议 提供 服务 ， 如 CoAP。1P 与 UDP 的 关系 如 图 3-11 所 示 。 

2.UDP Echo 示例 分 析 


在 UDP Echo 示例 代码 中 ， 客 户 端 和 服务 器 相互 配合 采用 “一 问 一 答 ” 的 方式 交换 数据 ， 这 种 工作 模式 称 为 “请 求 /响应 ”。 客 户 端 总 是 向 服务 器 发 起 请 求 ， 若 服务 器 接收 到 该 请 求 便 根 所 请求 的 内 容 返 
回 相应 的 响应 。UDP Echo 示例 正体 现 了 这 种 工作 模式 ， 只 是 负载 内 的 “Hello World! ”字符 串 并 没有 实际 含义 。 让 我 们 再 来 分 析 交换 “Hello World” 的 具体 流程 ， 该 交换 流程 如 图 3-12 所 示 。 


Hello World 应 用 数据 
源 端 口号 / 
目标 端口 号 


UDP 首部 Hello World UDP 数据 分 包 
源 IP 地 址 / 
日 标 IP 地 址 


IP 首 部 UDP 首 部 Hello World IP 数 据 分 包 


图 3-11 应 用 数据 被 封装 成 UDP 数据 包 


IP 地 址 192.168.0.3 IP 地 址 192.168.0.8 


UDP 客户 端 UDPHBI I ds in 


Us IPAE HE 192.168.0.3 

目标 卫 地 址 192.168.0.8 
icm L1 5753495 

H Erin O -55683 

应 用 数据 Hello World! 


源 IP 地 址 192.168.0.8 

目标 IP 地 址 192.168.0.3 
Uim F1 55683 

目标 端口 号 53495 
应 用 数据 Hello World! 


OC 
I 
1 


图 3-12 UDP Echo 工作 流程 
(1) UDP 客户 端 发 送 请 求 


UDP 客户 端 发 送 请 求 时 ， 在 IP 首 部 中 把 本 机 地 址 作为 源 IP 地 址 填 入 IP 首 部 的 源 IP 地 址 区 域 中 ， 把 远程 主机 的 IP 地 址 填 入 到 IP 首 部 的 目标 |P 地 址 区 域 中 。UDP 客 户 端 将 随机 生成 一 个 未 使 用 的 端口 号 ， 作 
为 源 端 口号 填 入 到 UDP 首部 中 的 源 端 口号 区 域 ， 而 把 远程 主机 的 端口 号 填 入 到 UDP 首部 中 的 目标 端口 号 区 域 。 


(2) UDP 服务 器 端 返 回响 应 
UDP 服务 器 填充 |P 首 部 和 UDP 首部 的 方式 与 UDP 客户 端 非常 类 似 ， 只 是 |P 首 部 中 的 “ 源 ” 和 “目标 ”完全 交换 了 位 置 。 
3.UDP 效 率 分 析 


在 UDP Echo 示例 中 ，UDP 有 效 负载 为 “Hello World! ” 共 12 字 节 ， 加 上 以 太 网 首部 14 字 节 、1Pv4 首 部 20 字 节 ，UDP 首 部 8 字 节 ， 整 个 数据 包 的 长 度 为 54 字 节 ， 请 求 和 响应 的 情况 几乎 相同 ， 那 么 此 
时 的 传输 效率 约 为 22%。 在 广泛 使 用 低 功 耗 受 限制 设备 的 物 联 网 领域 ， 传 感 器 检测 结果 一 般 都 较 短 ， 可 能 只 占用 10 字 节 到 20 字 节 ， 而 用 于 数据 传输 的 整个 数据 包 的 长 度 关 系 到 系统 的 电量 消耗 。 为 了 尽 可 能 
地 提高 效率 ， 我 们 总 是 希望 有 效 负载 占 整 个 数据 分 包 的 比例 越 大 越 好 。 此 处 22% 的 结果 可 能 并 不 是 一 个 好 成 绩 ， 但 是 对 于 同样 的 场景 应 用 TCP 可 能 低 得 多 。 


3.4 TCP 


TCP 是 一 种 功能 完备 的 面向 连接 的 传输 层 协议 ， 具 有 流 控制 、 传 输 确认 和 重 传 机 制 。TCP 给 应 用 提供 一 种 可 靠 的 、 以 字 节 流 形式 发 送 数 据 的 方法 ，TCP 具 有 如 下 很 多 广为人知 的 特点 : 


. 面向 连接 : 在 设备 之 间 发 生 数据 传输 之 前 ， 需 要 建立 一 个 连接 ， 数 据 通信 双方 都 需要 对 其 进行 管理 并 在 数据 传送 完成 之 后 将 其 关闭 。 
- 多 连接 : TCP 提 供 了 一 种 标识 连接 的 方法 ， 多 许 一 个 设备 有 多 个 连接 处 于 打开 状态 而 不 会 产生 冲突 。 
ERL: 一 旦 建立 连接 ， 数 据 可 以 在 两 个 方向 传输 。 


TCP 是 众多 应 用 层 协 议 的 传输 工具 ， 如 HTTP、SMTP 和 FTP 等 。 但 TCP 的 设计 也 有 其 “历史 局 限 性 ”，TCP 诞 生 的 年 代 因特网 并 未 普及 ， 网 络 设备 间 的 数据 传输 并 不 像 现 在 这 样 稳定 ， 所 以 TCP 设 计 者 通 
过 多 种 技术 手段 保证 其 可 靠 性 ， 这 大 大 提高 了 TCP 的 复杂 性 。 在 低 功 耗 受 限制 设备 中 ，TCP 并 不 是 唯一 的 选择 ， 保 证 传输 可 靠 性 也 可 以 通过 应 用 层 协议 并 根据 实际 情况 量力 而 行 。 
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本 节 通 过 一 个 示例 展现 TCP 工 作 的 大 概 流程 ， 然 后 通过 Wireshark 获 取 网 络 数据 ， 通 过 分 析 网 络 数据 的 方式 学 习 TCP 的 流程 与 细节 。 该 动手 示例 中 包含 两 个 角色 一 一 TCP 客 户 端 和 TCP 服 务 器 ，TCP 客 户 
端 由 Windows 主 机 实现 ， 而 TCP 服 务 器 由 树 莓 派 实 现 。 

1. 获 取 示 例 代码 


可 通过 Git 工 具 复制 本 书 提供 的 示例 代码 。 


# 新 建 一 个 名 为 repo 的 文件 夹 ， 若 已 经 复制 了 代码 ， 可 省 略 新 建文 件 夹 和 复制 步 又 
mkdir repo 

# clone 代 码 仓库 
git clone https://github.com/xukai871105/the beginning of coap.git 
# 进入 目录 

cd the beginning of coap 

# 进入 网 络 技 术 回 顾 示 例 代 码 文 件 夹 
cd review demo 

# 进入 tcp 示 例 目录 


cd tcp echo demo 


2.TCP 服 务 器 实现 
TCP 服 务 器 和 TCP 客 户 端 均 使 用 Python 3 编写 ， 示 例 代码 中 使 用 了 Python 3.4 之 后 自 带 的 异步 1O 处 理 框 架 asyncio。 
tcp_server.py 的 具体 代码 如 下 : 


代码 清单 3-3 tcp server.py 


import asyncio 


class EchoServerClientProtocol (asyncio.Protocol): 
def connection made(self, transport): 
peername = transport.get extra info('peername') 
print('Connection from [)'.format (peername)) 
self.transport - transport 


def data received(self, data): 
message = data.decode() 
print('Data received: {!r}'.format (message)) 


print('Send: (!r)'.format (message)) 
self.transport.write (data) 


print('Close the client socket') 
self.transport.close|() 


loop = asyncio.get event loop() 
coro = loop.create server (EchoServerClientProtocol, host-'0.0.0.0', port-8090) 
server = loop.run until complete (coro) 


print('Serving on {}'.format (server.sockets[0].getsockname ())) 
try: 


loop.run forever () 
except KeyboardInterrupt: 
pass 


server.close () 
loop.run until complete (server.wait closed () ) 
loop.close() 


(1) 创建 TCP 服 务 器 


通过 create_server 方 法 创建 一 个 TCP 服 务 器 ， 该 方法 传 入 三 个 参数 : EchoserverClient-Protocol 为 一 个 协议 实例 ， 该 实例 中 具有 多 个 回调 函数 ， 用 于 处 理 连 接 、 接 收 数据 处 理 等 事件 ; 
host= '0.0.0.0 用 于 绑 定 端口 号 ; “0.0.0.0 表示 侦 听 本 机 的 所 有 网 卡 ，port=8090 表 示 8090 为 侦 听 端口 号 。 


coro = loop.create server (EchoServerClientProtocol, '0.0.0.0', 8090) 


(2) 接收 数据 处 理 


在 EchoServerClientProtocol 中 ， 一 旦 TCP 服 务 器 接收 到 网 络 数据 ， 那 么 将 会 进入 data_received 回 调 函 数 ， 在 该 回调 函数 中 通过 data.decode 获 取 客 户 端 请 求 内 容 ， 最 后 通过 transport.write 原 样 返回 


class EchoServerClientProtocol (asyncio.Protocol): 
def data received(self, data): 
message = data.decode() 
print('Data received: [!rj'.format (message)) 


print('Send: (!r)'.format (message)) 
self.transport.write (data) 


3.TCP 客 户 端 实现 
TCP 客 户 端 的 代码 和 服务 器 的 代码 非常 相似 ， 在 运行 该 示例 之 前 需要 修改 此 处 raspberry ip_addrss 变 量 ， 并 把 该 变量 某 换 为 树 莓 派 的 实际 I|P 地 址 。 
tcp_client.py 的 代码 如 下 : 


代码 清单 3-4 cp client.py 


import asyncio 
f replace ip address here 
raspberry ip addrss = '192.168.0.8' 
class EchoClientProtocol (asyncio.Protocol): 
def init (self, message, loop): 
self.message = message 
self.loop - loop 


def connection made(self, transport): 
transport.write (self.message.encode()) 
print('Data sent: [!rj'.format (self.message)) 


def data received(self, data): 
print('Data received: (!r])'.format (data.decode())) 


def connection lost(self, exc): 
print('The server closed the connection!) 
print('Stop the event loop!) 
self.loop.stop() 


loop = asyncio.get event loop() 

message = 'Hello World!' 

coro = loop.create connection (lambda: EchoClientProtocol (message, loop), 
host-raspberry ip addrss, port-8090) 


loop.run until complete (coro) 
loop.run forever () 
loop.close() 


(1) 创建 TCP 客 户 端 


通过 create_connection 方 法 创建 TCP 客 户 端 ， 该 方法 传 入 两 个 参数 : EchoClient-Protocol (message, loop) 为 
host=raspberry ip addrss 用 于 指定 远程 主机 IP 地 址 ，port=8090 用 于 指定 远程 主机 端口 号 。 


个 协议 示例 ， 该 实例 处 理 网 络 连 接 、 连 接 去 失 和 接收 数据 等 事件 ; 


coro = loop.create connection (lambda: EchoClientProtocol (message, loop), 
host-raspberry ip addrss, port-8090) 


(2) &ÀX€ "Hello World" 


通过 transport.write 把 “Hello World" 发送 至 服务 器 端 。 


class EchoClientProtocol (asyncio.Protocol): 


def connection made(self, transport): 
transport.write (self.message.encode()) 
print('Data sent: [!rj'.format (self.message)) 


(3) 打印 接收 数据 


一 旦 接收 到 服务 器 返回 的 数据 ， 那 么 将 进入 datagram _received 回 调 函 数 ，data.decode () 中 便 是 服务 器 返回 的 “Hello World! " ， 打 印 服务 器 返回 的 数据 之 后 便 关 闭 TCP 连 接 。 


class EchoClientProtocol (asyncio.Protocol): 


def data received(self, data): 
print('Data received: (!r])'.format (data.decode ())) 


4. 执 行 示例 代码 


在 树 莓 派 控制 台中 输入 : 


Python3 tcp server.py 


在 Windows 控 制 台 中 输入 : 


python3 tcp client.py 


树 莓 派 控制 台 输 出 : 


Serving on ('0.0.0.0', 8090) 
Connection from ('192.168.0.3', 52908) 
Data received: 'Hello World!' 

Send: 'Hello World!' 

Close the client socket 


Windows 控 制 台 输出 : 


Data sent: 'Hello World!' 

Data received: 'Hello World!' 
The server closed the connection 
Stop the event loop 


5. 通 过 Wireshark 获 取 网 络 数据 


在 Windows 主 机 中 打开 Wireshark 选 择 合适 的 网 络 接口 ， 如 选择 本 地 连接 或 本 地 无 线 连接 ， 在 过 滤 栏 中 输入 “tcp.port==8090” 用 于 抓 取 所 有 端口 号 为 8090 的 TCP 数 据 分 包 。 从 Wireshark 的 抓 取 结 
可 以 看 出 ， 同 样 传输 “Hello World”，TCP 相 比 于 UDP 需要 更 多 的 步骤 。Wireshark 抓 取 的 网 络 数据 分 包 如 图 3-13 所 示 。 


No. Time Source Destination Protocol Length Info 


9 2.971655 ) 192.168.0.3 192.168.0.8 TCP 54 52908 > 8090 [ACK] Seq-1 Ack-1 Win=65536 Len=08 

10 2.972109 192.168.0.3 192.168.0.8 TCP 66 52908 > 8090 [PSH, ACK] Seq-1 Ack-1 Win-65536 Len-12 
11 2.972503 192.168.0.8 192.168.0.3 TCP 60 8090 ^ 52908 [ACK] Seq-1 Ack-13 Win-29248 Len-0 

12 2.977103 192.168.0.8 192.168.0.3 TCP 66 8090 > 52908 [PSH, ACK] Seq-1 Ack-13 Win-29248 Len-12 
14 2.978808 192.168.0.3 192.168.0.8 TCP 54 52908 ^ 8090 [ACK] Seq-13 Ack-14 Win-65536 Len-0 

17 2.980337 192.168.0.8 192.168.0.3 TCP 60 8090 ^ 52908 [ACK] Seq-14 Ack-14 Win-29248 Len-0 


图 3-13 Wireshark 3 TCP Echo 网 络 数 据 


34.2 TCP 首 部 
前 面 一 小 节 我 们 已 经 分 析 了 UDP 首部 的 具体 结构 ， 本 小 节 我 们 再 来 了 解 TCP 首 部 的 若干 细节 ，TCP 首 部 的 结构 相 较 于 UDP 要 复杂 得 多 。TCP 数 据 包 人 允许 一 个 数据 分 包 执行 多 个 功能 ， 通 过 这 种 方式 减少 


发 送 报 文 的 数量 ， 如 可 以 在 一 个 数据 包 中 发 送 数据 并 确认 先前 接收 的 一 个 数据 包 。TCP 的 种 种 特性 非常 适合 应 用 ， 但 是 天 下 没有 免费 的 午餐 ，TCP 的 首部 占用 20 字 节 ， 而 UDP 的 首部 仅 有 8 字 节 。TCP 首 部 的 
结构 如 图 3-14 所 示 。 


0 8 16 24 32 
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图 3-14 ”TCP 首部 


` 源 端 口号 (2 字 节 ) : 源 设备 上 发 送 数 据 包 进 程 的 16 位 端口 号 。 一 般 来 说 ， 对 于 请 求 数据 包 ， 它 是 一 个 客户 端 进程 ， 对 于 应 答 数据 包 ， 它 是 一 个 服务 器 端 进程 。 


- 目标 端口 号 (2 字 节 ) : 目标 设备 上 接收 进程 的 16 位 端口 号 。 一 般 来 说 ， 对 于 请 求 报 文 ， 它 是 一 个 服务 器 进程 ， 对 于 应 答 报 文 ， 它 是 一 个 客户 端 进程 。 


-ES (4 字 节 ) : 由 滑动 窗口 确认 系统 使 用 ， 作 为 数据 分 包 的 第 一 字 节 的 序号 。 在 SYN 位 置 为 1 的 情况 下 ， 它 表示 初始 序号 。 

AUF UFP) : 如 果 ACK 位 置 1， 该 字段 有 效 并 包含 设备 用 于 对 接收 到 的 数据 包 进 行 确 认 的 序号 。 

- 数据 偏 移 (ME) : 表示 数据 包 的 开始 位 置 与 TCP 首 部 的 开始 处 偏 移 多 少 个 32 位 〈4 字 节 ) 的 偏 移 量 。 该 字段 的 值 乘 以 4 才 可 以 得 到 字 节 形式 表示 的 偏 移 量 。 
. 控制 位 (6 位 ) : 用 于 相关 控制 信息 。 这 些 控制 位 包括 URG 紧 急 位 、ACK 确 认 位 、PUSH 推 送 位 、RST 复 位 位 、SYN 同 步 位 和 FIN 结 束 位 。 

. 窗口 : 用 于 流 控 制 ， 表 示 该 数据 包 的 发 送 者 在 一 定时 间 内 能 从 其 他 设备 接收 的 字 节 数 。 

. 校 验 和 : 用 于 检测 错误 的 16 位 校 验 和 。 


- 紧急 指针 : 如 果 URG 位 置 |， 该 字段 包含 紧急 数据 后 面 的 “正常 ”数据 的 第 一 字 节 的 序列 号 。 


3.4.3 TCP 示 例 分 析 


从 Wireshark 的 分 析 结 果 可 以 看 出 TCP 的 工作 方式 比 UDP 更 复杂 。 同 样 传输 “Hello World! ”，TCP 工 作 流 程 将 分 为 建立 连接 、 数 据 传输 和 关闭 连接 三 个 阶段 。TCP 的 工作 流程 如 图 3-15 所 示 。 
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图 3-15 ”了 CP 工作 流程 


1. 建 立 连 接 阶段 


连接 请 求 报 文 (SYN 报 文 ) 由 一 个 SYN 位 置 1 的 TCP 报 文 构成 ， 该 报 文中 包含 了 用 于 连接 的 初始 序列 号 。 服 务 器 收 到 客户 端的 连接 请 求 之 后 必须 向 客户 端 发 送 一 个 ACK 位 置 1 的 报 文 进行 确认 。 由 于 服务 
器 也 必须 将 自己 的 初始 序号 通知 客户 端 ， 所 以 为 了 不 发 送 两 个 独立 的 报 文 ， 所 以 把 报 文 中 的 SYN 位 置 1， 这 样 就 出 现 了 一 个 SYN 位 和 ACK 位 同时 置 1 的 报 文 。 最 后 客户 端 收 到 服务 器 发 来 的 SYN 报 文 之 后 ， 同 
样 需 要 对 其 进行 确认 。 这 就 是 “TCP 三 次 握手 ”。 


2. 数 据 传输 阶段 


数据 传输 阶段 与 UDP 通 信 类 似 ， 在 本 例 中 应 用 数据 报 文中 的 PSH 位 置 1， 那 么 TCP 将 会 立即 把 应 用 数据 发 送 给 服务 器 ， 服 务 器 接收 到 应 用 数据 之 后 将 会 返回 ACK 报 文 用 于 接收 报 文 确认 ， 表 示 服 务 器 完整 


地 接收 到 客户 端的 报 文 。 同 样 ， 服 务 器 原样 返回 客户 端的 请 求 数据 也 采用 PSH 发 送 、ACK 应 答 的 方式 。TCP 的 天 生 应 答 的 机 制 可 以 保证 数据 传输 的 可 靠 性 。 
3. 关 闭 连接 阶段 


关闭 连接 从 一 个 FIN 位 置 1 的 报 文 开始 ,一旦 设 备 接 收 到 FIN 报 文 ， 必 须 对 其 进行 确认 ， 也 就 是 说 接收 设备 必须 返回 ACK 报 文 。 关 闭 连 接 时 双方 都 需要 发 送 FIN 报 文 ， 同 时 双方 都 需要 对 FIN 报 文 进行 确 
认 。 这 就 是 “TCP 的 4 次 挥手 ”。 


3.4.4 UDP 与 TCP 对 比 


在 多 数 网 络 相关 的 技术 图 书 中 会 花费 大 量 的 篇 幅 介绍 TCP 的 各 种 特点 以 及 其 工作 机 制 ， 如 连接 管理 、 窗 口 控制 与 重 发 控制 、 流 控制 和 拥塞 控制 等 。 这 让 大 多 数 读者 产生 了 一 个 “误解 ”， 传 输 层 只 有 
TCP 才 可 以 保证 可 靠 性 而 UDP 则 是 “一 无 是 处 ”或 “漏洞 百出 ”。 其 实现 实情 况 并 不 是 这 样 的 。 


我 们 再 次 回 到 TCP 示 例 和 UDP 示例 中 ， 如 果 这 是 一 场 比赛 的 话 那么 规则 对 于 双方 都 非常 公平 ， 有 效 数 据 都 是 “Hello World! ”， 一 旦 收 到 了 请 求 数据 ， 服 务 器 直接 原样 返回 ， 最 终 有 效 数 据 为 两 
iX "Hello World! ” 共 24 字 节 。 


从 图 3-16 中 可 以 发 现 ，UDP 非 常 简单 直接 ， 请 求 报 文 和 响应 报 文 仅 包 含有 效 数 据 “Hello World! " , 而 TCP 为 了 传输 “Hello World! " , 需要 额外 的 连接 阶段 和 关闭 阶段 。 在 这 种 情况 下 ，UDP 的 传 
输 效 率 约 为 22% 左 右 ， 而 TCP 只 有 4% 左 右 。TCP 通 过 应 答 机 制 可 以 提高 可 靠 性 ,但 是 UDP 也 可 以 通过 应 答 机 制 提供 可 靠 性 ， 不 过 UDP 本 身 没 有 应 答 机 制 需 要 更 上 一 层 协 议 来 进行 确认 ，CoAP 正 是 采用 这 种 
折 中 策略 既 保证 了 传输 的 效率 也 保证 了 传输 的 可 靠 性 。 


所 以 对 于 物 联 网 设备 来 说 UDP 适用 性 更 好 ， 对 于 其 他 未 受 限制 的 设备 来 说 继续 使 用 TCP 也 无 可 厚 非 。 但 物 联网 设备 光 有 UDP 还 不 能 组 成 一 个 完整 的 应 用 ， 还 需要 应 用 层 协议 支持 才 行 。 当 前 已 经 有 非常 
多 的 应 用 层 协 议 采 用 TCP 作 为 传输 层 协议 ， 其 中 最 著名 的 便 是 HTTP。CoAP 与 HTTP 存 在 很 多 的 关联 性 ， 所 以 学 习 CoAP 之 前 非常 有 必要 了 解 HTTP。 
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图 3-16 UDP 和 TCP 对 比 


3.5 HTTP 


HTTP 是 Hyper Text Transfer Protocol ( 超 文 本 传输 协议 ) 的 缩写 。 它 的 发 展 是 万 维 网 协会 (World Wide Web Consortium) 和 IETF (Internet Engineering Task Force) 合作 的 结果 。 到 目前 为 
止 ， 已 经 有 很 多 个 版 本 的 HTTP 被 成 功 应 用 ， 包 括 HTTP 1.0 和 HTTP 1.1, HTTP 2.0 也 已 发 布 并 逐渐 推 向 应 用 。 相 比 于 HTTP 1.X, HTTP 2.0 有 非常 多 的 优势 ， 但 是 本 节 依 然 以 回顾 HTTP 1.x 为 主 。 


COoAP 借 鉴 了 HTTP 的 大 量 成 功 经 验 ， 如 果 已 经 熟练 掌握 HTTP 或 Web 开 发 的 话 ， 那 么 学 习 CoAP 将 变 得 相对 简单 。 如 果 还 没有 接触 过 HTTP 应 用 或 Web 开 发 的 话 ， 强 烈 建议 动手 党 试 本 节 的 例子 。 


35.1 JFR 


在 入 门 示例 中 ， 依 然 使 用 树 莓 派 作为 服务 器 ， 与 TCP 和 UDP 入 门 示例 不 同 ， 此 处 树 莓 派 将 作为 一 个 HTTP 服 务 器 。 相 比 于 TCP 和 UDP 服务 器 角色 ，HTTP 服 务 器 需要 承担 更 多 的 责任 。 此 时 浏览 器 将 作为 
客户 端 ， 在 浏览 器 的 地 址 栏 中 输入 树 莓 派 的 IP 地 址 加 上 一 个 约定 好 的 端口 号 便 可 访问 树 莓 派 提供 的 HTTP 服 务 。 HTTP 服 务 通 常 被 称 为 Web 服 务 ， 在 树 莓 派 中 建立 一 个 Web 服 务 有 非常 多 的 方法 ， 有 很 多 成 熟 
的 Web 框 架 可 以 使 用 ， 如 基于 Python 的 Flask 框 架 ， 或 者 基于 Node.js 的 Express 框 架 。 动 手 尝试 示例 试图 通过 现象 看 本 质 ， 所 以 使 用 哪个 框架 并 不 重要 。HTTP 动 手 党 试 示例 的 网 络 结构 如 图 3-17 所 示 。 
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图 3-17 HTTP 动手 党 


1. 安 装 Python Flask 


IP 地 址 192.168.0.8 


HTTP 服 务 器 


HTTP 请 求 | 


斌 入门 示例 


树 莓 派 中 已 经 默认 安装 了 Python 2 和 Python 3， 但 并 没有 安装 Flask 框 架 ， 所 以 要 给 树 莓 派 增加 Web 功 能 需要 通过 pip 工 具 为 Python 3 安装 Flask 框 架 。 在 树 莓 派 控制 台中 输入 以 下 指令 便 可 完成 Flask 框 
架 安 装 。 

sudo pip3 install flask 

2. 获 取 示 例 代码 


为 了 减少 读者 编写 代码 的 时 间 ， 可 直接 复制 本 书 示例 代码 。HTTP 示 例 代码 位 于 review_demoy/http_demo 目 录 中 。 


# 新 建 一 个 名 为 repo 的 文件 夹 ， 若 已 经 复制 了 代码 ， 可 省 上 略 新 建文 件 夹 和 复制 步骤 
mkdir repo 

# clone 代 码 仓库 
git clone https://github.com/xukai871105/the beginning of coap.git 
# 进入 目录 

cd the beginning of 
# 进入 网 络 技术 回忆 Esc BITS Sese 
cd review demo 

# 进入 http 示 例 目录 

cd http demo 


Web 应 用 总 是 可 分 为 前 端 实现 和 后 端 实现 两 部 分 。 后 端 一 般 用 于 处 理 用 户 请 求 、 从 数据 库 获 取 数 据 、 


代码 清单 3-5 app.py 


行 逻 辑 处 理 等 工作 。Web 后 端的 实现 代码 app.py 如 下 : 


# -*- coding: utf-8 -*- 
from flask import Flask, jsonify, render template, request 
app = Flask( name ) 


Qapp.route("/") 
def index(): 
return render template ('index.html') 


GQGapp.route('/value', methods-['POST']) 
def cal value(): 
if request.method == 'POST': 
a = request.form.get('a', 0, type-int) 
b = request.form.get('b', 0, type-int) 
return jsonify (result = a + b) 


Lf name ==" main 
app.run (host = 


". 
. 


'0.0.0.0',port = 8080, debug = True) 


app.py 主 要 有 两 个 路 由 功能 : 一 个 路 由 可 使 用 HTTP GET 方 法 访问 ， 返 回 一 个 htm| 页 面 ， 


(1) index.html 


知 使 用 浏览 器 客户 端 访 问 根 路 由 “/ 


该 路 由 可 理解 为 “主页 面 ”; 


， 那 么 Web 服 务 器 将 泻 染 一 个 index.html 文 件 并 把 该 文件 返回 给 浏 哆 


另 一 个 路 由 可 使 用 HTTP POST 方法 访问 ， 返 回 两 个 参数 a 和 b 相 加 的 结果 。 


，index.html 保 存在 http_ demo 的 templates 文 件 夹 中 。 


Qapp. route ("/") 
def index (): 
return render template ('index.html') 


(2) 计算 参数 a 和 b 之 和 


若 浏览 器 客户 端 访问 路 由 “/value” ， 那 么 Web 服 务 器 将 取出 客户 端 请 求 中 的 两 个 参数 a 和 b， 计 算 两 者 之 和 并 把 结果 作为 返回 内 容 。 浏 览 器 请 求 中 把 参数 a 和 参数 pb 通过 “a=12&b=34” 的 方式 组 织 起 
来 ， 而 Web 服 务 器 使 用 "( "result" : 46}” 这 样 的 JSON 格 式 包装 响应 。 
Qapp.route('/value', methods=['POST']) 


def cal _ value () : 
if request.method == 'POST': 


a = request.form.get('a', 0, type-int) 
b = request.form.get('b', 0, type-int) 
return jsonify (result = a + b) 


(3) 运行 Web 服 务 器 


指定 Web 服 务 的 端口 号 为 8080， 并 通过 debug=True 启 动 Flask 的 调试 功能 。 


if name ==" main : 
app.run(host = '0.0.0.0',port = 8080, debug = True) 


4.Web 前 端 实现 


在 入 门 示例 中 仅 包 括 一 个 前 端 页 面 index.html， 该 文件 位 于 templates 文 件 夹 中 。index.html 中 包含 几 个 HTML 元 素 和 一 小 段 Javascript 代 码 ， 而 Javascript 代 码 基 于 JQuery 编 写 。index.htm| 的 具体 实 
现代 码 如 下 : 


代码 清单 3-6 index.html 


<!DOCTYPE html» 
«html» 
«head» 
«meta charset-"utf-8"» 
«title»HTTP Demo«/title» 
«1-- 插入 jquery --» 
«script src-"[[url for('static', filename-'jquery.js')]]"»«/script» 
«script type-text/javascript» 
var SSCRIPT ROOT = [(írequest.script root|tojson|safe]); 
</script> E 
«script type-text/javascript» 
S(function() { 
function submit form(e) { 
$.ajax(t 
type: "post", 
url: SSCRIPT ROOT + '/value', 
data: { 
a: S('input[name-"a"]') .val(), 
b: S('input[name-"b"]').val(), 
now: new Date().getTime|() 


m 
success: function (data) { 
$ ('#result') .text (data.result); 


} 
]):; 


] 
// 绑 定 click 事 件 
$ 


('#calculate') .bind('click', submit form); 


); 
</script> 
</head> 
<body> 
<p> 


<input type=text size=5 name=a> + 
<input type=text size-5 name-b» = 


<span id-result»?«/span» 
</p> 
<p><input type="button" id-"calculate" value=" "></p> 
</body> 
</html> 


(1) 页 面 HTML 元 素 


index.htmlI 页 面 中 包括 的 HTML 元 素 很 少 ， 主 要 有 两 个 输入 框 ， 用 于 输入 参数 a 和 参数 b。 另 外 还 有 一 个 按钮 ， 点 击 按钮 将 会 触发 一 次 Ajax 异 步 请 求 。 这 个 简单 的 页 面 如 图 3-18 所 示 。 
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图 3-18 index.html 


(2) 执行 异步 请 求 


在 index.html 中 包含 一 段 JavaScript 代 码 ， 一 旦 1D 编号 为 calculate 的 HTML 元 素 被 单 击 ， 将 会 调用 submit form 函 数 。 在 subpmit form 函 数 中 取出 输入 框 中 a 和 b 的 内 容 ， 并 通过 Ajax 方式 提交 ， 最 后 把 
服务 器 的 返回 结果 显示 到 ID 编号 为 result 的 HTML 元 素 中 。 


$(function() { 
function submit form(e) { 
$.ajax(( 


type: "post", 
url: $SCRIPT ROOT + "'/value', 
data: { 
a: S('input[name-"a"] ').val(), 
b: S$S('input[name-"b"]').val(), 


now: new Date().getTime|() 
), 
success: function (data) { 
$ ('#result') .text (data.result); 
} 
p)? 


} 

// 绑 定 click 事 件 

$('4calculate').bind('click', submit form); 
JJF 


5. 执 行 示例 代码 

(1) 树 莓 派 中 启动 服务 器 
在 树 莓 派 控制 台 输入 : 
Python3 app.py 


(2) 获取 运算 结果 


在 Windows 主 机 中 打开 浏览 器 ， 在 浏览 器 地 址 栏 中 输入 Web 服 务 器 的 IP 和 应 用 端口 号 ， 如 http://192.168.0.8: 8080。 浏 览 器 将 会 获得 index.htm| 页 面 内 容 ， 在 该 页 面 中 填 入 参数 a 和 参数 b 的 值 ， 如 参 
数 a 输入 框 中 填 入 12， 参 数 b 输 入 框 中 填 入 34， 点 击 计 算 按钮 之 后 可 获得 Web 服 务 器 返回 的 计算 结果 46。 整 个 过 程 如 图 3-19 所 示 。 
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获取 计算 结果 


图 3-19 获取 运算 结果 


6. 运 行 分 析 


HTTP 相 关 的 网 络 数据 包 分 析 要 比 UDP 和 TCP 数 据 包 分 析 更 复杂 一 些 。 分 析 HTTP 请 求 响应 一 般 要 借助 浏览 器 的 调试 工具 和 Wireshark， 更 多 的 时 候 需 要 灵活 地 同时 使 用 两 种 工具 。 在 Firefox 浏 览 器 和 
Chrome 浏 览 器 中 可 使 用 快捷 键 《Ctrl+ shift+1》 进 入 开发 者 界面 ， 在 网 络 选项 卡 中 可 获取 HTTP 请 求 和 响应 的 所 有 信息 。 如 图 3-20 所 示 为 使 用 Firefox 浏 览 器 分 析 HTTP 请 求 响应 。 
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文件 


AO G 查看 器 OHE 
n EB HIML css 
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jquery.js 


请 求 网 址 : http://192.168.0.8:8080/value 
请 求 方法 : POST 
远程 地 址 : 192.168.0.8:8080 
状态 码 : 6 200 ok 
版 本 : HTTP/1.0 
a iDEA 
^ 响应 头 (0.144 KB) 
请 求 头 (0.401 KB) 
Host: "192.168.0.8:8080" 


字体 ”图像 ”媒体 


jă 192.168.0.8:80... 
fll 192.168.0.8:80... 
192.168.0.8:80... 


EEMLI- b] H d$ Bex 
Fash ws 其 他 (2 Q URL 
类 型 pret 大 小 
html 0.91 KB 0.89 KB 
84.33 KB 84.33 KB 


© 性 能 


域名 


Js 


User-Agent: "Mozilla/5.0 (Windows NT 10.0; WOW64; rv:48.0) Gecko/20100101 Firefox/48.0" 


Accept: "*/** 


Accept-Language: "zh-CN,zh;q-0.8,en-US;q-0.5,en;q- 0.3" 


Accept-Encoding: "gzip, deflate" 


Content-Type: "application/x-www-form-urlencoded; charset=UTF-8" 


X-Requested-With: "XMLHttpRequest" 
Referer: "http://192.168.0.8:8080/" 


图 3-20 使 用 Fitefox 浏 览 器 分 析 HTTP 请 求 响应 


3.5.2 HTTP 工作 模式 


Web 开 发 包括 前 端 、 后 端 和 数据 存储 等 多 个 部 分 ， 


随 着 Web 的 飞速 发 展 出 现 了 各 种 各 样 的 开发 框架 ， 


这 些 开 发 框架 给 开发 者 带 来 了 越 来 越 多 的 便利 ， 但 也 使 得 代码 离 HTTP 本 身 越 来 越 远 。 从 本 质 上 来 


说 HTTP 设 计 原 则 和 TCP 或 者 UDP 非常 相似 ，HTTP 也 由 首部 和 负载 两 部 分 组 成 ，HTTP 首 部 决定 了 HTTP 本 身 的 相关 特性 ， 而 HTTP 负 载 则 用 于 传输 更 上 层 的 应 用 协议 ， 这 些 内 容 包 括 HTML、(CSS、 


Javascript、JSON 和 XML 等 内 容 。HTTP 采 用 TCP 作 为 传输 层 协议 ， 其 与 TCP、1P 的 关系 如 图 3-21 所 示 。 


HTTP 首 部 


TCP 首 部 


源 IP 地 址 /目标 IP 地 址 


TCP 首 部 


HTTP 首 部 


HTTP 首 部 


应 用 数据 


TCP 数 据 分 包 


IP 数 据 分 包 


HTTP 采 用 请 求 / 响 应 的 工作 模式 ， 


图 3-21 HTTP 与 TCP IP 的 关系 


总 是 存在 HTTP 客 户 端 和 HTTP 服 务 器 ， 客 户 端 负责 发 起 HTTP 请 求 ， 服 务 器 根据 HTTP 请 求 返回 HTTP 响 应 。 在 HTTP 入 门 示例 中 ， 客 户 端 总 共 发 起 了 至 少 3 次 请 求 。 


1) 当 用 户 在 浏览 器 中 输入 服务 器 IP 地 址 和 端口 号 时 ， 执 行 第 一 次 GET 请求， 服务 器 把 index.html 作 为 响应 返回 给 客户 端 。index.html 本 质 为 一 个 文本 文件 ， 但 HTTP 中 称 它 为 超 文本 文件 ， 浏 览 器 将 把 


该 文件 重新 泻 染 ， 这 


2) 由 于 index.html 中 定义 了 jquery.js 文 件 ， 所 以 浏览 器 将 自动 向 服务 器 获取 jquery.js 文 件 。 这 个 过 程 用 户 一 般 不 会 感觉 到 但 是 该 过 程 的 确 会 发 生 。 


文 使 得 用 户 看 到 的 模样 和 index.html 本 身 完全 相同 。 


3) 当 用 户 点 击 了 计算 按钮 ， 那 么 浏览 器 将 执行 一 次 POST 请 求 ， 服 务 器 将 返回 计算 结果 。 计 算 结果 采用 JSON 格 式 包装 ， 经 过 处 理 之 后 在 页 面 内 显示 结果 。 这 个 过 程 用 户 可 以 感觉 到 ， 但 是 一 般 不 会 在 


意 浏览 器 到 底 做 了 什么 。 


HTTP 采 用 TCP 作 为 传输 层 协 议 ， 那 么 获取 index.html 之 前 ， 客 户 端 和 服务 器 之 间 还 发 送 了 
更 复杂 


例 的 流程 要 显得 


IP 地 址 192.168.0.3 


HTTPA FP ij 

| SYN : 
t— — —  ——QVN PY ——n 
e SYN ACK 7| 
! ACK i 
GET/ 
e indehtm — —  — | 
! GET /static/jquery.]s : 
jp———————— ———————Ha 

Jquery.]s 


3.5.3 HTTP 首部 


GET /value?a=12&b=34 
'result":46! 


T] 
z 


m» 
Ti. 


图 3-22 HTTP 客户 端 和 服务 器 数据 交换 过 程 


了 解 HTTP 的 工作 模式 之 后 ， 我 们 接着 了 解 HTTP 的 首部 内 容 。 由 于 本 书 篇 幅 限 制 ，HTTP 的 更 多 内 容 可 参考 《HTTP 权 威 指南 》 一 书 ， 


1. 请 求 报 文 和 响应 报 文 结构 


“三 次 握手 ”和 “四 次 挥手 ”。 整 个 数据 交换 过 程 如 图 3-22 所 示 。 相 比 于 UDP 和 TCP 入 门 示例 ，HTTP 入 门 示 


IP 地 址 192.168.0.8 


HTTP 服 务 需 


连接 建立 阶段 


数据 传输 阶段 


1. 获得 HTML 页 面 
2. 获得 JQuery 脚 本 
3. 获取 JSON 结 果 


连接 关闭 阶段 


与 TCP 和 UDP 首部 不 同 ，HTTP 首 部 为 一 个 文本 类 型 首部 ， 而 TCP 和 UDP 首部 为 一 个 二 进 制 首部 。 HTTP 请 求 报 文 和 HTTP 响 应 报 文 的 结构 稍 有 不 同 ， 请 求 报 文中 第 一 行 总 是 请 求 行 而 响应 报 文 的 第 一 行 总 


是 状态 行 。HTTP 首 部 中 没有 指定 首部 长 度 ， 所 以 在 HTTP 首 部 和 负载 之 间 存 在 一 个 空 行 ， 该 空 行使 用 “ 回 车 + 换行 ”表示 。HTTP 的 首部 结构 如 图 3-23 所 示 。 


图 3-23 HTTP 首部 结构 


2. 请 求 行 


HTTP 首 部 中 的 请 求 行 包括 HTTP 方 法 、URI 和 HTTP 版 本 三 部 分 。HTTP 首 部 中 的 请 求 行 的 结构 如 图 3-24 上 半 部 分 所 示 。 
.HTTP 方法 : 包括 GET、POST、PUT 和 DELETE 等 。 
URI: 用 于 描述 服务 器 资源 位 置 ， 它 与 浏览 器 中 使 用 的 URL 并 不 完全 等 同 ，URI 仅 包括 域名 之 后 的 部 分 ， 如 URIL 为 http://www.example.com/user/12， 那 么 此 时 的 URI 为 /user/12。 
- HTTP 版 本 : 指定 客户 端 在 其 请 求 中 使 用 的 HTTP 版 本 ， 其 合法 值 为 HTTP/1.0 或 HTTP/1.1。 
3. 状 态 行 
HTTP 首 部 中 的 状态 行 包括 HTTP 版 本 、 状 态 码 和 原因 短语 三 部 分 。HTTP 首 部 中 的 状态 行 的 结构 如 图 3-24 下 半 部 分 所 示 。 
. HTTP 版 本 : 指定 服务 器 在 其 响应 中 使 用 的 HTTP 版 本 ， 其 合法 值 为 HTTP/1.0 或 HTTP/1.1。 
` 状态 码 和 原因 短语 : 状态 码 反映 服务 器 处 理 客户 端 请 求 的 结果 ， 该 信息 用 一 个 3 位 数字 表示 ， 而 原因 短语 使 用 文本 形式 表示 。 


下 面 是 一 个 非常 受 欢迎 的 状态 行 ， 如 果 获 取 该 状态 行 表示 服务 器 成 功 处 理 了 请 求 。 


HTTP/1.0 200 OK 


请 求 行 


URI 


POST /value HTTP/I.1 
状态 行 


HTTP 版 本 


HTTP/1.1 200 


图 3-24 请求 行 与 状态 行 结构 
4.HTTP 请 求 报 文 和 响应 报 文 举例 


结合 本 节 人 入 门 示例 给 出 一 组 比较 完整 的 HTTP 请 求 和 响应 示例 ， 昌 然 省 略 了 部 分 内 容 但 是 依然 可 以 反映 HTTP 请 求 与 响应 过 程 的 全 狐 。 


(1) HTTP 请 求 报 文 一 一 异步 提交 内 容 


在 Windows 浏 览 器 中 点 击 “ 提 交 ” 按 钮 ， 浏 览 器 使 用 Ajax 方式 把 内 容 POST 至 服务 器 。 


POST /value HTTP/1.1 
Host: 192.168.0.8:8080 


User-Agent: Mozilla/5.0 
Accept: */* 
Content-Type: application/x-www-form-urlencoded; charset=UTF-8 
X-Requested-With: XMLHttpRequest 

Content-Length: 27 

Connection: keep-alive 


a-12&b-34&now-1472309742455 


(2) HTTP 响 应 报 文 一 一 返回 JSON 内 容 


Web 服 务 器 通过 JSON 格 式 包装 响应 结果 ， 并 返回 给 浏览 器 客户 端 。 


HTTP/1.0 200 OK 

Content-Type: application/json 
Content-Length: 14 

Server: Werkzeug/0.11.10 Python/3.4.2 


("result":46] 


354 HTTP 请 求 方法 


根据 HTTP 标 准 ，HTTP 请 求 可 以 使 用 多 种 请 求 方法 。HTTP 1.0 标 准 定义 了 三 种 请 求 方法 : GET、POST 和 HEAD 方 法 。HTTP 1.1 标 准 又 新 增 了 五 种 请 求 方法 ， 即 OPTIONS、PUT、DELETE、TRACE 和 
CONNECT 方 法 。 如 表 3-1 所 示 。 


3-1 HTTP 请 求 方法 
序 号 请 求 方 法 T Y 
l GET 请 求 指定 资源 ， 并 返回 实体 主体 


类 似 于 GET 请 求 ， 但 返回 的 响应 中 没有 具体 的 内 容 ， 可 用 于 获 
取 HTTP 报 文 首部 


器 指定 资源 提交 数据 (例如 提交 表单 或 者 上 传 文件 )。 数 据 被 包 
POST 含 在 HTTP 请 求 负 载 中 。POST 请 求 可 能 导致 新 的 资源 的 建立 和 / 
或 已 有 资源 的 修改 


4 PUT 客户 端 回 服 务 硕 请 求 的 数据 更 新 指定 的 资源 
5 DELETE 请 求 服 务 器 删除 指定 的 资源 
CONNECT HTTP1.1 协议 中 预 留 给 能 够 将 连接 改 为 管道 方式 的 代理 服务 融 
7 OPTIONS 允许 客户 端 查看 服务 右 的 性 能 
8 TRACE 回 显 服务 硕 收 到 的 请 求 ， 主 要 用 于 测试 或 诊断 


2 HEAD 


U 


ON 


3.5.55 HTTP 状态 码 


HTTP 状 态 码 是 当 客 户 端 向 服务 器 发 送 HTTP 请 求 时 ， 描 述 返 回 的 请 求 结果 。 借 助 状态 码 客 户 端 可 以 知道 服务 器 是 正常 处 理 了 请 求 还 是 出 现 了 某 种 错误 。 如 表 3-2 所 示 为 HTTP 状 态 码 和 原因 短语 。 


表 3-2 HTTP 状 态 码 和 原因 短语 


状态 码 类 型 状态 码 与 原因 短语 说 明 


100 Continue Ze P yp ex Hgok 


信息 报 文 "PN 服务 器 同意 带 有 更 新 首部 的 客户 端 请 求 ， 改 变 在 该 连接 
上 正在 使 用 的 应 用 层 协议 
成 功 
成 功 成 功 ， 但 不 返回 任何 实体 的 主体 部 分 
成 功 执行 了 一 个 范围 请 求 
永久 性 重 定 回 ， 啊 应 报 文 的 Location 首部 应 该 有 该 资源 
重 定向 的 新 URL 
客户 端 发 送 附 市 条 件 的 请 求 (请 求 首 部 中 包含 如 If- 
Modified-Since 等 指定 首部 ) 时 ， 服 务 端 有 可 能 返回 304, 
此 时 啊 应 报 文中 不 包含 任何 报 文 主体 
服务 端 在 执行 请 求 时 发 生 了 错误 
HE 5H | 
服务 器 暂 时 无 法 提供 服务 ， 可 以 包 售 Rety Aer HER 


3.5.6 HTTP 首部 字段 


HTTP 首 部 字段 是 构成 HTTP 报 文 的 要 素 之 一 ， 在 客户 端 与 服务 器 之 间 的 HTTP 请 求 响应 过 程 中 ， 无 论 是 请 求 还 是 响应 都 会 使 用 首部 字段 。HTTP 首 部 字段 使 用 首部 字段 名 和 字段 值 构成 ， 中 间 使 用 冒 
号 “: ”风格 , 例如: 


首部 字段 名 : 首部 字段 值 


HTTP 首 部 字段 按照 实际 用 途 分 为 通用 首部 字段 (General Header Fields) 、 请 求 首部 字段 (Request Header Fields) 、 响 应 首部 字段 (Response Header Fields) 和 实体 首部 字段 (Entity Header 


Fields) 4 个 部 分 : 
- 通用 首部 字段 : 包括 Connection、Data 和 Upgrade 等 。 
.请求 首部 字段 : 包括 Host、User-Agent、Accept、If-Match 和 Range 等 。 
“ 响应 首部 字段 : 包括 Age、Location 和 Set-Cookie 等 。 


实体 首部 字段 : 包括 Content-Encoding、Content-Length、Content-Type、Content-Range 和 Etag 等 。 


3.5.7 HTTP 的 优势 与 问题 


虽然 HTTP 已 经 在 互联 网 领域 取得 了 非常 广泛 的 应 用 ， 但 是 它 也 存在 一 些 被 人 忽略 的 问题 。 为 了 在 物 联网 领域 借鉴 HTTP 的 优势 并 克服 HTTP 的 缺陷 ，CoAP 应 运 而 生 。 
1. 优 势 

HTTP 的 确 具有 不 少 优势 ， 而 且 这 些 优 势 依然 可 以 在 物 联 网 领域 继续 延续 。 

(1) 简单 的 工作 模式 


HTTP 采 用 请 求 / 响 应 的 工作 模式 ， 这 样 一 问 一 答 的 方式 使 得 系统 设计 更 加 简单 。HTTP 请 求 总 是 由 客户 端 发 起 ， 服 务 器 对 请 求 做 出 响应 。HTTP 采 用 无 状态 设计 方式 ，HTTP 请 求 时 总 是 带 上 一 些 必 要 的 信 
息 ， 这 使 得 服务 器 不 必 保 留 多 余 的 关于 客户 端的 信息 。 这 种 无 状态 设计 方式 降低 了 服务 器 的 实现 复杂 度 。 


(2) 完整 的 方法 定义 


HTTP 定 义 了 多 种 请 求 方法 ， 在 REST 风 格 下 这 些 请 求 方法 和 数据 库 操作 中 的 “增删 改 查 ”建立 了 完整 的 对 应 关系 。 在 REST 风 格 下 服务 器 API 设 计 变 得 越 来 越 简单 清晰 ， 这 也 在 软件 实现 层面 降低 了 复杂 


m 


(3) 合理 的 状态 码 设计 


HTTP 中 设计 了 4 种 不 同类 型 的 状态 码 ， 这 些 状态 码 帮 助 应 用 完成 了 最 基本 的 错误 处 理 。 通 过 这 种 方式 也 可 降低 具体 应 用 的 设计 复杂 程度 。 


(4) 友好 的 媒体 类 型 支持 


HTTP 负 载 类 型 定义 非常 灵活 ，HTTP 负 载 可 以 是 各 种 各 样 的 媒体 类 型 ， 这 些 媒体 类 型 包括 文本 类 型 、 图 片 类 型 、 视 频 类 型 或 者 任何 一 种 二 进 制 类 型 。HTTP 的 这 种 定义 方式 把 更 多 的 “想象 空间 ” 留 给 具 
体 应 用 ， 这 使 得 现 阶 段 的 Web 应 用 变 得 如 此 丰富 多 彩 。 


2. 问 题 


当然 HTTP 并 不 是 完美 的 ， 随 着 时 代 的 发 展 人 们 对 HTTP 也 有 了 更 多 现实 的 认识 。 这 些 问 题 包括 元 长 的 文本 首部 和 单 向 传输 方式 。 这 些 问题 的 暴露 也 导致 新 的 协议 的 产生 ， 如 CoAP 和 Websocket。 近 年 
来 HTTP 本 身 也 有 不 少 的 改进 ，HTTP 2.0 版 本 是 一 个 全 新 的 HTTP 版 本 。 


(1) 元 长 的 文本 首部 


HTTP 采 用 文本 首部 的 设计 方式 ， 这 些 文本 首部 虽然 便于 人 类 阅读 ， 但 是 也 使 得 HTTP 首 部 变 得 越 来 越 元 长 。 例 如 Content-Type: application/json， 该 首部 字段 传输 过 程 中 将 占用 29 字 节 。 另 外 HTTP 
采用 无 状态 方式 设计 ， 这 使 得 每 次 请 求 的 HTTP 首 部 都 很 长 ， 这 种 方式 在 物 联网 领域 肯定 是 一 种 浪费 。 在 物 联网 领域 ,设备 上 传 传感器 结果 可 能 只 有 十 几 或 二 十 几 字 节 ， 教 条 地 使 用 HTTP 将 会 把 宝贵 的 带宽 
浪费 在 传输 HTTP 首 部 上 而 不 是 应 用 数据 本 身 。 


(2) 单 向 传输 方式 


HTTP 请 求 /响应 模式 也 限制 了 HTTP 的 传输 方向 ， 服 务 器 不 能 主动 地 向 客户 端 传输 数据 。Websocket 可 以 解决 HTTP 的 这 种 问题 ， 并 与 HTTP 配 合 默契 。WebsSocket 建 立 起 浏览 器 和 服务 器 之 间 的 双向 通 
道 。 另 外 HTTP 2.0 也 解决 了 该 问题 ， 允 许 服 务 器 直接 向 客户 端 传输 数据 。 
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本 章 回 顾 了 互联 网 领域 被 广泛 使 用 的 网 络 技术 ， 这 些 技术 包括 IP、UDP、TCP 和 HTTP。IP 部 分 回顾 了 IP 的 两 个 版 本 IPv4 和 IPv6，IPv4 虽 然 在 现 阶段 被 广泛 应 用 , 但 是 由 于 地 址 枯竭 并 不 能 满足 物 联网 设 


备 的 需求 ， 可 以 预见 在 不 久 的 将 来 IPv6 将 在 物 联 网 设备 中 取得 一 定 的 成 绩 。 本 章 还 回顾 了 传输 层 的 两 个 重要 协议 UDP 和 TCP， 无 论 是 UDP 还 是 TCP 小 节 ， 都 通过 一 个 实际 的 例子 说 明 它 们 的 工作 方式 。 
UDP 设计 简单 ， 而 TCP 包 括 了 “三 次 握手 ”和 “四 次 挥手 ”， 并 且 每 个 TCP 报 文 都 需要 ACK 报 文 作为 响应 ，TCP 表 现 出 良好 的 可 靠 性。 但 通过 本 章 中 的 TCP 和 UDP 比较 ， 在 传输 相同 内 容 的 情况 下 ，UDP 比 
TCP 效 率 更 高 ， 可 以 说 UDP 更 适合 物 联 网 设备 。 本 章 最 后 还 回顾 了 HTITP，HTTP 应 用 非常 广泛 ， 该 小 节 回 顾 了 HTTP 请 求 方法 、HTTP 状 态 码 和 请 求 首 部 字段 等 内 容 。 虽 然 HITP 在 互联 网 领域 占有 统治 地 位 ， 


但 它 的 元 长 首部 也 使 得 它 在 物 联网 领域 力不从心 。 


IPv4、IPv6、UDP、TCP 和 HTTP 都 是 CoAP 的 “兄弟 姐妹 ”， 学 习 与 回顾 这 些 内 容 对 CoAP 的 学 习 非 常 有 价值 ， 此 时 CoAP 可 以 使 用 一 个 比较 直观 的 公式 说 明 它 与 IPv4、IPv6、UDP 和 HTTP 的 关系 ， 如 图 3- 


25 所 示 。 


IPv4/IPv6 | mim ») mm | 一 :并 市 (HTTP) 


图 3-25 ”CoAP 与 IPv4、IPv6、UDP 和 HTTP 的 关系 
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本 章 试图 通过 一 个 简单 示例 为 大 家 开启 CoAP 旅 程 ， 这 个 简单 的 示例 包括 一 台 已 经 安装 Firefox (火狐 ) 浏览 器 的 个 人 电脑 。 入 门 示例 将 会 在 Firefox 浏 览 器 中 安装 一 个 名 为 Copper 的 插件 。 该 插件 提供 完 
整 的 CoAP 客 户 端 调试 功能 ， 只 需 知晓 CoAP 服 务 器 的 IP 地 址 或 域名 ， 借 助 该 插件 便 可 向 服务 器 提交 CoAP 请 求 ， 除 了 提交 CoAP 请 求 之 外 还 可 以 设置 CoAP 请 求 参数 。 入 门 示例 使 用 Arduino UNO 作 为 CoAP 
服务 器 。Arduino UNO 仅 拥有 2KB 大 小 的 内 存 ， 虽 然 只 有 2KB 内 存 空 间 ， 但 其 资源 也 可 以 满足 一 个 CoAP 服 务 器 的 基本 要 求 。 为 了 使 Arduino UNO 具 有 联网 功能 ， 还 需要 为 Arduino UNO 增 加 网 络 扩展 
板 ，Arduino 网 络 扩展 板 有 很 多 种 型 号 ， 本 章 推荐 使 用 W5100。 


CoAP 入 门 示例 的 具体 组 成 如 图 4-1 所 示 ， 安 装 有 Firefox 浏 览 器 的 Windows 主 机 作为 CoAP 客 户 端 ， 而 Arduino UNO 作 为 CoAP 服 务 器 。CoAP 服 务 器 提供 数量 有 限 的 几 种 服务 ， 在 REST 风 格 下 这 些 服务 
也 可 以 称 为 资源 。 由 Arduino UNO 组 成 的 CoAP 服 务 器 具有 一 个 hello 资 源 ， 通 过 GET 方 法 可 获得 hello 资 源 ，hello 资 源 包含 一 个 固定 字符 串 内 容 “Hello CoAP! ”。 除 了 hello 资 源 之 外 ，CoAP 服 务 器 还 提 
共 一 个 名 为 light 的 资源 ， 该 资源 支持 GET 方 法 和 PUT 方法 访问 ， 通 过 CoAP GET 方 法 可 获得 该 资源 内 容 ， 通 过 CoAP PUT 方法 可 修改 该 资源 的 内 容 ， 结 合 GET 和 PUT 方法 ， 可 以 把 虚拟 资源 的 操作 直接 映射 到 


^N 


真实 资源 中 ， 例 如 此 处 的 light 资 源 对 应 一 个 真实 的 LED， 入 门 示例 中 真实 的 LED 与 Arduino UNO 的 D8 脚 相连 。 


CoAPJIE I %7 192.168.0.10 


CoAPÆ JU GET/hello 


2.05 Content 
“Hello CoAP!" 


PUT /led *1" 


2.05 Content 
Nl 


/EN OOo pur led “0” 


2.05 Content 


LinuxzY Windows 
Arduino UNO - Arduino Ethernet 


图 4-1 CoAP Arduino 示 例 


入 门 示例 试图 说 明 CoAP 本 身 非 常 简 单 ， 而 且 几 乎 可 以 在 任何 硬件 中 运行 。 通 过 该 入 门 示例 可 建立 学 习 CoAP 的 信心 。 虽 然 本 章 的 示例 非常 简单 且 容 易 掌握 ， 但 依然 要 求实 验 者 掌握 若干 基本 技能 和 技 
巧 ， 这 些 技能 和 技巧 包括 : 


- Arduino IDE 使 用 技能 : 如 新 建 Arduino UNO 工 程 、 如 何 编写 程序 、 如 何 下 载 固件 等 。 
- Arduino 硬 件 操 作 技 能 : 如 如 何 给 Arduino 上 电 、 如 何 连 接 以 大 网 扩展 模块 、 如 何 连 接 LED 等 。 


Git 工 具 使 用 技能 : 如 如 何 通 过 github 访 问 项 目 网 址 、 如 何 复 制 代码 、 如 何 拉 取 最 新 代码 等 。 
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本 章 试图 通过 一 个 简单 示例 为 大 家 开启 CoAP 旅 程 ， 这 个 简单 的 示例 包括 一 台 已 经 安装 Firefox (火狐 ) 浏览 器 的 个 人 电脑 。 入 门 示例 将 会 在 Firefox 浏 览 器 中 安装 一 个 名 为 Copper 的 插件 。 该 插件 提供 完 
整 的 CoAP 客 户 端 调试 功能 ， 只 需 知晓 CoAP 服 务 器 的 |P 地 址 或 域名 ， 借 助 该 插件 便 可 向 服务 器 提交 CoAP 请 求 ， 除 了 提交 CoAP 请 求 之 外 还 可 以 设置 CoAP 请 求 参数 。 入 门 示例 使 用 Arduino UNO 作 为 CoAP 
服务 器 。Arduino UNO 仅 拥有 2KB 大 小 的 内 存 ， 虽 然 只 有 2KB 内 存 空 间 ， 但 其 资源 也 可 以 满足 一 个 CoAP 服 务 器 的 基本 要 求 。 为 了 使 Arduino UNO 具 有 联网 功能 ， 还 需要 为 Arduino UNO 增 加 网 络 扩展 
板 ，Arduino 网 络 扩展 板 有 很 多 种 型 号 ， 本 章 推荐 使 用 W5100。 


CoAP 入 门 示例 的 具体 组 成 如 图 4-1 所 示 ， 安 装 有 Firefox 浏 览 器 的 Windows 主 机 作为 CoAP 客 户 端 ， 而 Arduino UNO 作 为 CoAP 服 务 器 。CoAP 服 务 器 提供 数量 有 限 的 几 种 服务 ， 在 REST 风 格 下 这 些 服务 
也 可 以 称 为 资源 。 由 Arduino UNO 组 成 的 CoAP 服 务 器 具有 一 个 hello 资 源 ， 通 过 GET 方 法 可 获得 hello 资 源 ，hello 资 源 包含 一 个 固定 字符 串 内 容 “Hello CoAP! ”。 除 了 hello 资 源 之 外 ，CoAP 服 务 器 还 提 
共 一 个 名 为 light 的 资源 ， 该 资源 支持 GET 方 法 和 PUT 方法 访问 ， 通 过 CoAP GET 方 法 可 获得 该 资源 内 容 ， 通 过 CoAP PUT 方法 可 修改 该 资源 的 内 容 ， 结 合 GET 和 PUT 方法 ， 可 以 把 虚拟 资源 的 操作 直接 映射 到 
真实 资源 中 ， 例 如 此 处 的 light 资 源 对 应 一 个 真实 的 LED， 入 门 示例 中 真实 的 LED 与 Arduino UNO 的 D8 脚 相连 。 


CoAP 服 务 需 192.168.0.10 
GET/hello ————————— 


2.05 Content 
“Hello CoAP!" ! 
oS 


CoAP7€ F! “mi 


PUT /led *1" 


2.05 Content 
Nl 


/ES PUT Aed “0 


O y 
2.05 Content 


Linux% Windows ————PP—————— 
Arduino UNO - Arduino Ethernet 


KJ4-1 CoAP Arduino 示 例 


入 门 示例 试图 说 明 CoAP 本 身 非 常 简单 ， 而 且 几 乎 可 以 在 任何 硬件 中 运行 。 通 过 该 入 门 示例 可 建立 学 习 CoAP 的 信心 。 虽 然 本 章 的 示例 非常 简单 且 容 易 掌握 ， 但 依然 要 求实 验 者 掌握 若干 基本 技能 和 技 
巧 ， 这 些 技能 和 技巧 包括 : 


- Arduino IDE 使 用 技能 : 如 新 建 Atduino UNO 工 程 、 如 何 编 写 程序 、 如 何 下 载 固 件 等 。 
- Arduino 硬 件 操 作 技 能 : 如 如 何 给 Arduino 上 电 、 如 何 连 接 以 太 网 扩展 模块 、 如 何 连 接 LED 等 。 


- Git 工 具 使 用 技能 : 如 如 何 通 过 github 访 问 项 目 网 址 、 如 何 复 制 代码 、 如 何 拉 取 最 新 代码 等 。 


4.2 Copper 揪 件 入 | ] 


Copper 是 一 款 Firefox 浏 览 器 插件 ， 毫 无 疑问 Copper 是 最 容易 使 用 的 CoAP 客 户 端 工具 。 由 于 Copper 仅 仅 是 Firefox 浏 览 器 的 一 个 扩展 插件 ， 所 以 只 要 有 Firefox 浏 览 器 便 可 使 用 Copper 插 件 。 无 论 在 
Windows 平 台 还 是 Linux 平 台 都 可 以 随心 所 欲 地 使 用 Copper 插 件 ， 并 且 使 用 步骤 和 体验 细节 都 完全 相同 。 


注 
© 所 Coppet 仅 仅 是 Firefox 的 一 个 扩展 搞 件 ， 并 不 能 在 Chrome 或 者 IE 浏 览 器 中 使 用 。 


4.2.1 Copper 插件 安装 


Copper 揪 件 的 安装 非常 简单 ， 首 先 需要 保证 计算 机 中 已 经 安装 了 合适 版 本 的 Firefox 浏 览 器 。 在 Firefox 浏 览 器 的 地 址 栏 中 输入 https://addons.mozilla.org/en-US/firefox/addon/copper-270430/， 
点 击 “Add to Firefox” ， 重 启 Firefox 浏 览 器 便 可 完成 Copper 揪 件 安装 。 安 装 Copper 持 件 之 后 Firefox 浏 览 器 便 可 识别 以 “coap: //” 开 头 的 URI。 如 图 4-2 所 示 。 


dẹ Copper (Cu) = Add-ons .. X 


( € | © @ Mozilla Foundation (US) | https//addo * VU 8& | C — CPfirefoxcopper > A + f$ 多 |- 


Copper (CU) o1241-sgned1-siged REQUIRES RESTART 
U by Matthias Kovatsch 


7 user reviews 
1,851 users 


The Copper (Cu) CoAP user-agent for Firefox installs a handler for the 'coap' URI 
scheme and allows users to browse and interact with Internet of Things devices. 
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图 4-2 ”Firefox 浏 览 器 中 安装 Coppet 插 件 


4.2.2 Copper 插件 入 门 示例 

虽然 Copper 揪 件 安装 过 程 非常 简单 ， 但 Copper 揪 件 的 功能 却 一 点 也 不 简单 。CoAP 插 件 的 具体 使 用 细节 请 参考 8.2 节 ， 此 处 仅 通过 入 门 示例 说 明 Copper 揪 件 的 使 用 方法 。 若 Copper 揪 件 安装 成 功 可 使 
用 CoAP 测 试 服务 器 验证 Copper 揪 件 的 基本 功能 ， 入 门 示例 中 推荐 两 台 CoAP 测 试 服 务 器 ， 它 们 分 别 是 : 

: 国外 CoAP 测 试 服务 器 : coap: //californium.eclipse.org/ 


: 国内 CoAP 测 试 服务 器 : coap: //wsncoap.org/ 


注 
O CoAP 服 务 器 的 网 址 一 般 以 coap 开 头 ， 而 常见 的 Web 服 务 器 的 网 址 一 般 以 http 或 https 开 头 。 国 外 CoAP 服 务 器 由 eclipse ptoject 负 责 维 护 ， 而 国内 CoAP 服 务 由 本 书 作 者 负责 维护 ， 内 CoAP 服 务 器 部 署 
于 阿里 云 。 一 般 来 说 ， 国 内 CoAP 测 试 服务 器 较 国 外 CoAP 测 试 服务 器 更 容易 访问 。 


入 门 示例 以 国内 服务 器 coap: //wsncoap.org/ 为 例 说 明 Copper 插 件 的 使 用 方法 。 在 Firefox 浏 览 器 的 地 址 栏 中 输入 “coap: Mwsncoap.org/”， 按 下 “Enter” 键 之 后 Firefox 浏 览 器 界面 将 发 生 明 显 
变化 ， 此 时 Firefox 浏 览 器 的 外 观 如 图 4-3 所 示 。 在 Copper 插 件 的 工具 栏 中 点 击 “GET” 按钮 ， 此 时 Copper 插 件 将 使 用 CoAP GET 方 法 向 wsncoap.org 服 务 器 发 送 一 次 CoAP 请 求 ，wsncoap.org 服 务 器 接收 
到 请 求 之 后 将 会 返回 CoAP 响 应 。 


wsncoap.org:5683 


| € © | coap:;//wsncoap.org/ 


2.05 Content (Blockwise) (Download finished) 


Header Value Option Value 
Type ACK Content-Format text/plain Request Options 
Code 2.05 Content Block2 7 (64 B/block) Accept 


MD 13822 


Token Ox5A2D Content-Format 
Combined Payload (494 
© Incoming £j Rendered! (3) Outgoing | Block! (Req) Block? (Res.)Auto 


CoÀP RPC 7252 | Sizel Size2 


ing the Calif u- i| [total size x] [total size x] 
This server is using the Californium (C£) CoAP framework : total size X 


published by the Eclipse Foundation under EPL-*EDL: * Observe 


http://www. eclipse. org/californium/ 


(c) 2014, Institute for Pervasive Computing, ETH Zurich ETag 


Contact: Matthias Kovatsch 4kovatschfinf. ethz. ch» : 
| use hex (0x..) or string X 


If-Match 


0x79091BEA X 


C] If-None-Match v 
C > 


图 4-3 coap: //wsncoap.org/ 


mh "GET" 按钮 之 后 ，Copper 揪 件 的 Incoming 选 项 卡 中 将 不 停 地 更 新 内 容 ， 若 Copper 揪 件 完成 接收 CoAP 响 应 ， 那 么 Copper 揪 件 的 状态 栏 将 显示 “2.05 Content (Blockwise) (Download 
finished) ”。 在 这 个 接收 响应 的 过 程 中 可 以 明显 发 现 ，CoAP 响 应 并 不 是 以 一 个 完整 数据 分 包 的 形式 返回 至 CoAP 客 户 端 ， 而 是 被 分 成 了 若干 个 数据 分 包 依 次 返回 至 客户 端 。 昌 然 CoAP 服 务 器 返回 响应 内 容 
较 少 ， 但 依然 被 CoAP 服 务 器 切割 成 多 个 数据 分 包 返 回 至 CoAP 客 户 端 。 与 HTTP 不 同 ，CoAP 主 要 为 受 限 制 低 功 耗 设 备 服务 ， 所 以 CoOAP 中 包含 了 分 组 传输 功能 ， 黑 认 情 况 下 Copper 默 认 数 据 分 包 的 大 小 为 64 
字 节 。 相 比 于 HTTP，CoAP 的 分 包 长 度 要 小 得 多 。 


使 用 CoAP GET 方 法 从 wsncoap.org 测 试 服务 器 获取 的 完整 响应 内 容 如 下 : 


Ckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckckck ck 


CoAP RFC 7252 

大 大 大 大 大 大 大 大 大 大 大 大 大 大 类 大 大 大 大 大 类 大 大 类 大 大 大 大 大 类 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 大 类 大 大 大 
This server is using the Californium (Cf) CoAP framework 
published by the Eclipse Foundation under EPL+EDL: 
http://www.eclipse.org/californium/ 


(c) 2014, Institute for Pervasive Computing, ETH Zurich 


Contact: Matthias Kovatsch «kovatschüinf.ethz.ch» 
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若 仔细 观察 响应 内 容 可 以 发 现 wsncoap.org 服 务 器 使 用 Californium (Cf) CoAP frame-work 实 现 CoAP 服 务 器 。Californium (Cf) CoAP framework 是 一 个 非常 完善 的 CoAP 软 件 实现 框架 ， 可 简称 
为 Cf 框 架 。 Cf 框 架 既 包括 CoAP 客 户 端 实现 也 包括 CoAP 服 务 器 端 实现 ， 除 了 常规 非 加 密 的 UDP 传输 方式 之 外 ， 该 框架 还 支持 基于 DTLS 的 加 密 传输 ，Cf 框 架 的 具体 使 用 方法 详 见 7.5 节 。 


O Coppet 插 件 通过 图 文 并 诚 的 方式 展现 CoAP 请 求 和 响应 结果 ， 再 加 上 Coppert 插 件 在 浏览 器 中 运行 ， 使 得 首次 使 用 CoAP 的 用 户 觉得 CoAP 也 和 HTTP 一 样 存在 “页 面 ” 的 概念 。 其 实 CoAP 并 没有 “页 


面 ”， 它 仅仅 是 一 个 应 用 层 协 议 。 从 另 一 个 角度 来 说 HTTP 也 没有 “页 面 ”，HITITP 只 是 从 Web 服 务 器 中 获取 了 相应 的 HIML 文件 ， 浏 览 器 把 获取 的 HIML 文件 中 每 个 标记 重新 展现 至 终端 用 户 ， 这 种 重新 展现 
的 过 程 可 称 为 “ 泻 染 ”， 通 过 “ 泻 染 ”动作 把 枯燥 无 味 的 文本 变 成 了 多 姿 多 彩 的 页 面 


4.3 Arduino CoAP 服 务 器 实现 


Firefox 浏 览 器 中 的 Copper 揪 件 是 一 个 非常 实用 的 CoAP 客 户 端 ， 但 在 CoAP 应 用 中 总 是 存在 两 个 角色 一 一 CoAP 客 户 端 和 CoAP 服 务 器 ， 本 节 将 说 明 如 何 使 用 Arduino UNO 和 Arduino Ethernet Shield 
以 太 网 扩展 板 实现 一 个 非常 简洁 的 CoAP 服 务 器 。 


4.3.04 ”获取 示例 


在 Arduino UNO CoAP 服 务 器 部 分 的 实现 代码 位 于 本 书 代码 仓库 the_beginning_of_coap 中 ， 可 通过 Git 工 具 复 制 本 书 提 供 的 示例 代码 。 


es 
新 建 一 个 名 为 repo 的 文件 夹 (repo 是 repository 仓 库 的 简称 ) 


ius -P repo 


# 复制 代码 仓库 
git clone https://github.com/xukai871105/the beginning of coap.git 
# 进入 示例 代码 目录 


cd the beginning of coap 


Arduino CoAP 服 务 器 实现 的 示例 代码 位 于 first_demo/microcoap 目 录 中 。 该 目录 中 包括 3 个 重要 文件 ， 即 microcoap.ino、coap.c 和 coap.h， 其 中 : 


: microcoap.ino 7] Arduino UNO 的 工程 文件 ， 该 文件 实现 串口 初始 化 、 网 络 初 始 化 、 接 收 CoAP 请 求 、 处 理 CoAP 请 求 和 返回 CoAP 响 应 等 功能 ， 可 在 mictocoap.ino 文 件 中 增加 各 种 CoAP 路 由 ， 这 些 路 由 可 称 
为 endpoint (端点 ) ， 又 可 称 为 资源 。 入 门 示例 中 包含 两 个 endpoint (端点 ) : 一 个 endpoint 名 为 “hello”， 另 一 个 endpoint 名 为 “led”。 


coap.c 和 coap.h 为 CoAP 的 实现 代码 ， 该 部 分 代码 实现 了 CoAP 首 部 解析 和 填充 、 选 项 解析 和 填充 、 负 载 分 离 和 填充 等 功能 。 一 般 情 况 下 coap.c 和 coap.h 并 不 需要 修改 。coap.c 和 coap.h 仅 实现 CoAP 中 很 多 基 
础 功能 ， 但 它 并 不 包括 CoAP 重 传 和 CoAP 分 组 传输 等 其 他 功能 。 


4.3.2 示例 说 明 


microcoap.ino 可 分 为 初始 化 、CoAP 数 据 处 理 、endpoints 列 表 、hello 资 源 和 light 资 源 等 部 分 ， 各 部 分 的 详细 说 明 如 下 。 
1. 初 始 化 


在 Arduino 应 用 程序 中 总 有 一 个 setup 国 数 和 一 个 loop 函 数 ，setup 国 数 主要 用 于 完成 设备 初始 化 工作 ， 在 入 门 示例 中 ，setup 阔 数 主要 实现 led 初 始 化 、 串 口 初始 化 和 网 络 设备 初始 化 等 工作 ， 有 具体 实现 
代码 如 下 。 


代码 清单 4-1 初始 化 部 分 代码 


#include <SPI.h> 
#include «Ethernet.h» 
#include <EthernetUdp.h> 


static int led = 8; 

// 自 定义 网 卡 地 址 

byte mac[] = (0x00, OxAA, OxBB, OxCC, OxDE, 0x02); 
// Arduino 主 机 地 址 ， 请 根据 实际 网 络 情况 修改 

IPAddress ip(192, 168, 0, 10); 

IPAddress gateway(192, 168, 0, 1); 

IPAddress subnet(255, 255, 255, 0); 


EthernetUDP udp; 
uint8 t packetbuf [256]; 


void setup () 

{ 
int i; 
pinMode (led, OUTPUT); 
Serial.begin(9600); 


Ethernet.begin (mac, ip); 
// 打印 本 机 IPv4 地 址 

Serial.print("My IP address: "); 
for (120; i < 4; i++) 


{ 


Serial.print (Ethernet.localIP()[i], DEC); 
Serial.print("."); 


} 
Serial.println(); 
// 侦 听 5683 端 口 的 UDP 输入 数据 
udqp .pegin (5683); 
} 


在 setup 函 数 中 : 
: pinMode (led, OUTPUT) 初始 化 LED 为 输出 模式 ， 入 门 示例 中 LED 与 Atduino 的 D8 有 和 脚 相连 。 


: Serial.begin (9600) 设置 串口 波 特 率 ， 此 处 的 波 特 率 为 9600bit/s。 借 助 Arduino 的 串口 功能 打印 程序 运行 过 程 中 的 调试 信息 ， 这 些 调 试 信息 包括 Arduino 本 机 IPv4 地 址 、 其 他 主机 发 送 至 Arduino 的 UDP 数 
据 包 等 。 


: Ethetnet.begin (mac, ip) 设置 W5100 网 卡 的 MAC 地 址 和 IPv4 地 址 。 
. udp.begin (5683) 绑 定 UDP 5683 端 口号 ， 通 过 5683 端 口 接收 CoAP 请 求 。 
2.CoAP 数 据 处 理 


CoAP 数 据 处 理 部 分 位 于 loop 函 数 中 ，CoAP 数 据 处 理 部 分 从 Arduino UDP 服 务 器 演变 而 来 。 通 过 udp.parsePacket 函 数 可 获取 当前 UDP 数 据 包 字 节 长 度 ， 如 果 UDP 数 据 包 长 度 大 于 0 说 明 Arduino 接 收 
到 其 他 主机 发 送 而 来 的 CoAP 请 求 ;通过 coap_parse 函 数 验 证 并 解析 该 CoAP 请 求 ， 若 验证 通过 将 遍历 endpoints 数 组 ，endpoints 数 组 包含 hello 资 源 处 理 浮 数 和 |light 资 源 处 理 函 数 ， 若 CoAP 请 求 中 的 URI 
与 相应 endpoint 的 URI 匹 配 ， 那 么 coap_handle_req 将 会 通过 函数 指针 的 方式 调用 资源 处 理 函 数 ; 若 CoAP 请 求 执行 完成 ， 将 通过 coap_build 构 造 CoAP 响 应 ; 最 后 通过 udp_send 函 数 向 CoAP 客 户 端 返 回响 
应 内 容 。CoAP 请 求 的 处 理 流程 如 图 4-4 所 示 。 


udp.parsePacket() 
获取 UDP 数据 包 长 度 


udp.read() 
获取 UDP 数据 包 


coap parse() 


验证 并 解析 CoAP 请 求 一 打印 错误 信息 


coap handle req Bi Fiendpointe rz 
处 理 CoAP 请 求 ji Jj en poin sH 


coap build 
构造 CoAP 啊 应 


udp send 
返回 UDP 数据 包 
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图 4-4 ”CoAP 请 求 处 理 流 程 


CoAP 请 求 处 理 部 分 代码 如 下 所 示 。 


代码 清单 4-2 CoAP 请 求 处 理 


void udp send(cons 


{ 


udp.beginPacket 
while (buf 
udp.write (*bul 


Flen-- 


t uint8 t 


) 


£4); 


udp.endPacket () ; 


) 


(udp.remotel 


*buf 


int bu 


, 


flen) 


P(), udp.remotePort ()); 


void loop() 
{ 
int sz; 
Int Tc: 
coap packet t pkt; 
int i; 
if ((sz = udp.parsePacket()) > 0) 
{ 
// 读 取 UDP 请 求 内 容 
udp.read(packetbuf, sizeof (packetbuf 
for (i = 0; i < sz; i++) 
{ 
Serial.print (packetbuf[i], HEX); 
Serial.print(" "); 


) 


Serial.prin 


tin orm); . 


// 验证 并 解析 CoAP 请 求 
if (0 != (rc = coap parse (&pkt, packetbuf, sz))) 
{ 
Serial.print("Bad packet rc-"); 
Serial.println(rc, DEC); 
} 
else 
{ 
size t rsplen = sizeof (packetbuf); 
coap packet t rsppkt; 
// 处 理 CoAP 请 求 
coap handle req(&scratch buf, &pkt, &rsppkt, endpoints) 
memset (packetbuf, O, UDP TX PACKET MAX SIZE); 
if (0 t= (rc = coap | build (packetbuf, &rsplen, &rsppkt))) 
{ 
Serial.print("coap build failed rc-"); 
Serial.println(rc, DEC); 
} 
else 
// 返回 CoAP 响 应 
udp send(packetbuf, rsplen); 


3.endpoints 列 表 


程序 进 


行 CoAP 


UP 


端点 集合 (也 可 以 理解 为 路 由 集合 


或 资源 集合 


n 


中 ， 每 一 个 端点 由 请 求 方法 、 请 求 处理 函 数 、 请 求 URI 和 媒体 类 型 组 成 ， M Reno, 


coap endpoint t endpoints[] 


(COAP METHOD GET, handle get hello, &path hello, "ct-0"], 
(COAP METHOD GET, handle get light, &path light, "ct-0"], 
(COAP METHOD PUT, handle put light, &path light, NULL], 
{ (coap method t)0, NULL, NULL, NULL} 
}; 
microcoap.ino 中 包含 三 个 不 同 的 端点 (路 由 或 资源 ) 一 一 支持 GET 方 法 的 “hello” 端 点 、 
而 “light” 端 点 不 但 支持 GET 方 法 还 支持 PUT 方法 。 
4.hello 资 源 
hello 资 源 需要 由 URI 和 路 由 处 理子 数 两 部 分 定义 。hello 资 源 实现 代码 如 下 : 
static const coap endpoint path t path hello = (1, ("hello"]]; 
static int handle get hello(coap rw buffer t *scratch, 
const coap : packet - t *inpkt, coap packet t *outpkt, 
uint8 t id hi, uint8 t id lo) 
{ 
char hello[32] = "Hello CoAP!"; 
return coap make response (scratch, outpkt, 
(const uint8 t *)&hello, strlen (hello), 
id hi, id lo, &inpkt->tok, 
COAP RSPCODE CONTENT, COAP CONTENTTYPE TEXT PLAIN); 
} 
在 上 述 代码 中 : 


- coap_endpoint_path_t path hello- (1, 


: handle get hello (> 


5.light 资 源 


) 定义 hello 资 


次 源 的 处 理子 


"hello" Y 3X hello w 44 URI , 


数 ， 该 处 理 函 数 将 会 向 CoAP 客 户 端 


该 资源 的 URI 为 “hello”， 


支持 GET 方 法 的 “light” 端 点 和 支持 PUT 方 法 的 “light” 端 点 。 此 处 “hello 


通过 coap: //192.168.0.10/hello 便 可 访问 该 资源 。Arduino 入 门 示 例 中 该 


返回 字符 串 形式 的 固定 负载 “Hello CoAP! ”。 


light 资 源 也 由 URI 和 路 由 处 理子 数 两 部 分 组 成 。 相 比 于 hello 资 源 ，light 资 源 既 支 持 CET 方 法 也 支持 PUT 方法 。 


static char light = '0'; 
static int led = 8; 
static const coap endpoint path t path light = (1, ("light"]]; 
static int handle get light(coap rw buffer t *scratch, 
const coap packet t *inpkt, coap packet t *outpkt, 
uint8 t id hi, uint8 t id lo) 
{ 
return coap make response (scratch, outpkt, 
(const uint8 t *)&light, 1, 
id hi, id lo, &inpkt-»tok, 
COAP RSPCODE CONTENT, COAP CONTENTTYPE TEXT PLAIN); 
) 
static int handle put light(coap rw buffer t *scratch, 
const coap : packet t *inpkt, coap packet t *outpkt, 
uint8 t id hi, uint8 t id lo) 


=~ H- 


// 若 CoAP 负 载 的 首 个 字符 为 1 


(inpkt-»payload.p[0] 
light =: TL"; 
digitalWrite (led, HI 


| 
[ 


Serial.println ("ON"); 


GH) ; 


vv) 


L4 


， 说 明 CoAP 客 户 端 试图 打开 LE 


D 


- 
Li 


， 每 个 端点 表示 一 个 COAP 请 求 处理 的 最 小 “单元 ”。 


" NB BÉ 


Mg Ka 


fEmicrocoap.ino 


点 仅 支 持 GET 方 法 ， 


资源 仅 支 持 GET 方 法 。 


} 

else 

{ 
light = '0'; 
digitalWrite (led, LOW); 
Serial.println ("OFF"); 


) 
return coap make response (scratch, outpkt, 
(const uint8 t *)&light, 1, 
id hi, id lo, &inpkt-»^tok, 
COAP RSPCODE CHANGED, 
COAP CONTENTTYPE TEXT PLAIN); 


在 上 述 代 码 中 : 


* coap_endpoint_path_t path_light={1，{"light"}} 定 义 该 资源 的 URI， 该 资源 的 URI 为 “light”， 可 通过 coap: //192.168.0.10Vlight 便 可 访问 该 资源 ， 与 hello 资 源 不 同 ， 该 资源 既 支 持 GET 方 法 也 支持 PUT 方 
法 ， 也 就 是 说 可 通过 PUT 方法 改变 资源 的 状态 ， 即 通过 PUT 方法 修改 LED 点 亮 或 熄灭 。 


` handle get light () 即 light 资 源 处 理 函 数 之 一 ， 该 处 理 函 数 支持 GET 方 法 ， 将 返回 此 时 LED 的 状态 ，LED 的 状态 通过 一 个 名 为 light 的 字符 变量 进行 保存 ， 当 light 的 值 为 “0 时，LED 处 于 熄灭 状态 ; 
light 的 值 为 “1” 时 ，LED 处 于 点 亮 状态 。 


handle_put_light () 即 light 资 源 处 理 函 数 之 一 ， 该 处 理 函 数 支持 PUT 方 法 。 若 请 求 负 载 的 值 为 “1” 时 ， 通 过 dipgitalWtite (led, HIGH) 点 亮 LED; 车 请 求 负载 的 值 不 为 “1” 时 ， 通 过 
digitalWrite (led, LOW) J& XLED. 


4.3.3 ”动手 测试 


过 以 上 代码 分 析 应 该 对 入 门 示例 的 运行 流程 有 一 个 大 体 的 了 解 ， 下 面 再 通过 动手 测试 环节 加 深 对 上 述 代码 和 运行 流程 的 理解 。 
1. 网 络 参 数 修改 
开始 运行 代码 之 前 建议 根据 网 络 的 实际 情况 修改 入 门 示例 中 的 相关 参数 ， 示 例 代 码 中 与 网 络 有 关 的 参数 一 共有 三 项 : 


IPAddress ip(192, 168, 0, 10); 
IPAddress gateway(192, 168, 0, 1); 
IPAddress subnet(255, 255, 255, 0); 


通过 IPAddress ip (192, 168, 0, 10) 指定 Arduino 的 IPv4 地 址 为 192.168.0.10， 该 IPv4 地 址 为 一 个 局 域 网 IPv4 地 址 。 在 大 多 情况 下 PC 的 IPv4 地 址 均 由 路 由 器 分 配 获 得 ， 但 在 入 门 示 例 中 Arduino 使 
用 固定 IPv4 地 址 ， 一 定 要 确认 Arduino 的 IPv4 地 址 处 于 路 由 器 所 指定 的 网 段 中 ; IPAddress gateway (192, 168, 0, 1) 指定 了 路 由 器 的 IPv4 地 址 ，IPAddress subnet (255, 255, 255, 0) 指定 子 网 掩 
码 。 如 果 不 清楚 本 地 局 域 网 信息 ， 可 在 Windows 主 机 中 通过 控制 台 输 入 ipconfig 命 令 查询 。 


例如 ， 路 由 器 的 IP 地 址 为 192.168.1.1， 子 网 掩 码 为 255.255.255.0， 测 试 使 用 Windows 主 机 的 IPv4 地 址 为 192.168.1.101， 可 设置 Arduino 的 IPv4 地 址 为 192.168.1.108， 修 改 之 后 的 网 络 参 数 如 下 : 


IPAddress ip(192, 168, 1, 108); 
IPAddress gateway(192, 168, 1, 1); 
IPAddress subnet(255, 255, 255, 0); 


完成 了 网 络 参 数 的 设置 之 后 ， 那 么 便 可 动手 进行 测试 工作 ， 相 比 于 枯燥 的 文档 说 明 ， 调 试 过 程 更 容易 积累 COAP 的 使 用 经 验 。 在 Arduino 中 运行 示例 工程 ， 先 把 固件 下 载 至 Arduino UNO 目 标 板 中 ， 操 
作 过 程 如 图 4-5 所 示 。 


2. 连 接 CoAP 服 务 器 


完成 固件 下 载 之 后 先 使 用 ping 命 令 查看 Arduino UNO 是 否 可 达 ， 若 未 收 到 Arduino 的 响应 需 检 查 Arduino 相 关 的 网 络 参数 ， 并 及 时 修改 microcoap.ino 中 的 具体 设置 。 本 例 中 Arduino 的 IP 地 址 为 
192.168.0.10， 固 件 下 载 完成 之 后 可 顺利 ping 通 Arduino 设 备 ， 若 获得 如 图 4-6 所 示 的 相似 结果 ， 则 说 明 Arduino UNO 和 Arduino 网 络 扩展 卡 工作 良好 。 


EÐ microcoap | Arduino 1.6.9 


Xf Sam 项 目 DES 帮助 


microcoap 


&include <stdint. h> 
#include <EthernetUdp. h> 
#include "coap. h” 
#include "endpoints. h” 


#define PORT 5683 

byte mac[] = {0x00, OxAA, OxBB, OxCC, OxDE, 0x02]: 
IPAddress ip(192, 168, 0, 10); 

IPAddress gateway(182, 168, 0, 1); 

IPAddress subnet(255, 255, 255, 0); 


EthernetClient client; 

EthernetUDP udp; 

uint8 t packetbuf [256]; 

static uint8 t scratch raw [32]; 

static coap rw buffer t scratch buf = [scratch raw, sizeof(scratch raw)]; 


MAHT 15,084 7m: 占用 了 (46%) EIFE o PRAA 32,256 Fo 
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图 4-5 ”下载 入 门 示例 固件 至 Arduino 目 标 板 中 


选择 节令 提示 符 


ers\Think>ping 192. 168. 0. 10 
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图 4-6 ”连接 CoAP 服 务 器 
lo 资源 
验证 了 网 络 连 通 性 之 后 可 使 用 Firefox 浏 览 器 中 的 Copper 插 件 获 取 hello 资 源 ， 具 体操 作 过 程 如 图 4-7 所 示 。 
1) 打开 Firefox 浏 览 器 ， 在 地 址 栏 中 输入 coap: //192.168.0.8: 5683/hello， 按 下 回 车 键 , 浏览 器 界面 出 现 明显 变化 、。 


2) 点 击 工具 栏 中 的 GET 按 钮 ， 通 过 浏览 器 向 Arduino UNO 发 送 一 次 CoAP GET 请 求 。 


3) 点 击 GET 按 钮 之 后 便 可 在 负载 区 域 Incoming 选 项 卡 中 观察 到 “Hello CoAP! " ， 此 时 CoAP 响 应 码 为 “2.05 Content" , 
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图 4-7 使 用 Coppet 插 件 获取 hello 资 源 


GET 方 法 是 CoAP 中 最 常用 的 方法 之 一 ， 由 于 hello 资 源 本 身 的 限制 每 次 通过 GET 方 法 访问 资源 后 只 能 获得 一 人 ! ”。 下 面 通过 一 个 可 变化 的 过 程 说 明 如 何 通 过 CoAP 控 制 
设备 。 

4. 访 问 与 修改 light 资 源 

与 hello 资 源 不 同 ， bea a i did 第 一 步 通过 PUT 方 法 修改 资源 ， 负 载 内 容 设置 为 “1”，PUT 请 求 成 功 发 送 之 后 LED 将 处 于 点 亮 状 态 ;第 二 步 通过 


GE 方法 重新 获取 该 资源 ， 查 看 获取 的 负载 是 否 已 经 变 大 
(1) 使 用 PUT 方法 修改 资源 
通过 PUT 方法 可 控制 LED 状 态 使 其 点 亮 或 熄灭 ， 若 点 亮 LED 可 把 PUT 请 求 负载 设置 为 “1” ， 具 体操 作 过 程 如 图 4-8 所 示 。 
1) 打开 Firefox 浏 览 器 ， 在 地 址 栏 中 输入 coap: //192.168.0.10: 5683/light, 
2) 在 负载 区 域 的 outgoing 选 项 卡 中 输入 “1 
3) gu "PUT" 按钮 ， 向 Arduino 发 送 一 次 CoAP PUT 请 求 。 


4) 若 Arduino 正 确 处 理 PUT 请 求 ， 将 会 向 Copper 揪 件 返回 响应 ， 此 时 响应 码 为 “2.04 Changed" , 
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图 4-8 修改 light 资 源 
(2) 重新 获取 light 资 源 
通过 上 一 步 操作 LED 将 处 于 点 亮 状态 ，light 资 源 也 已 经 发 生 改 变 ， 通 过 GET 方 法 可 以 重新 获取 该 资源 以 验证 资源 是 否 被 正确 修改 ， 验 证 过 程 如 图 4-9 所 示 。 
1) 打开 Firefox 浏 览 器 ， 在 地 址 栏 中 输入 coap: //192.168.0.10: 5683/light。 
2) 点 击 工具 栏 中 的 “GET” 按 钮 ， 向 Arduino 发 送 GET 请 求 。 


3) 若 Arduino 正 确 处 理 CoAP 请 求 ， 可 在 负载 区 域 Incoming 选 项 卡 中 观察 到 “1” ， 此 时 CoAP 响 应 的 响应 码 为 “2.05 Content" , 


43.4 ”着 手 分 析 
最 后 再 通过 Wireshark 抓 取 网 络 数 据 尝试 分 析 CoAP 的 具体 细节 。 面 几 步 操作 已 经 对 CoAP 工 作 流程 有 一 个 大 致 的 了 解 ， 那 么 通过 Wireshark 工 具 可 对 CoAP 本 身 有 一 个 更 全 面 的 了 解 。 当 然 此 时 不 
熟悉 CoAP 的 细节 也 没有 关系 ， 第 5 章 将 会 对 此 进行 更 为 详细 的 分 析 。 


打开 Wireshark， 选 择 合适 的 网 卡 侦 听 网 络 分 组 数据 ， 如 选择 有 线 网 卡 或 无 线 网 卡 ; 在 Wireshark 过 滤 栏 中 输入 “coap”。 再 次 使 用 Copper 揪 件 访问 Arduino UNO 中 的 hello 资 源 。 在 Wireshark 中 可 
以 “截获 ”两 个 UDP 数据 包 ， 其 中 一 个 UDP 数据 包 代 表 CoAP 请 求 ， 另 一 个 UDP 数据 包 代表 CoAP 响 应 。 两 个 UDP 数据 包 数 据 流 向 和 大 致 内 容 如 图 4-10 所 示 。 
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图 4-9 重新 获取 light 资 源 


192.108.0.3 192.168.0.10 


CoA PAZ F! rg 


CoAPHb S d 


UDP: 5683 
GET /hello 


2.05 Content 
Hello CoAP! 


图 4-10 ”通过 Wireshatk 获 取 CoAP 请 求 响应 


1.CoAP 请 求 分 析 
在 CoAP 请 求 中 可 以 观察 到 如 图 4-11 所 示 的 类 似 内 容 ， 这 些 内 容 包 括 : 
: UDP 目 标 端 口号 为 5683， 该 端口 为 CoAP 协 议 的 知名 端口 (默认 端口 ) 。 
' CoAP 请 求 方法 为 GET。 
: CoAP 请 求 路 由 为 “hello”。 
2.CoAP 响 应 分 析 
在 CoAP 响 应 中 可 以 观察 到 如 图 4-12 所 示 的 类 似 内 容 ， 这 些 内 容 包 括 : 
: CoAP 响 应 码 为 “2.05 Content” o 


- CoAP 响 应 负载 为 “Hello CoAP! ” 


Rice 8 à à à 1  BI3-)Ewet- | + 应 用 此 过 小 器 


Time Source Destination Protocol Length Info 


6 1.687122  192.168.0.10 192.168.0.3 61 ACK 


> Frame 5: 54 bytes on wire (432 bits), 54 bytes captured (432 bits) on interface 0 
> Ethernet II, Src: LcfcHefe a0:87:8d (50:7b:9d:a0:87:8d), Dst: 00:aa:bb:cc:de:02 (00:aa:bb:cc:de:02) 
» Internet Protocol Version 4, Src: 192.168.0.3, Dst: 192.168.0.10 
v User Datagram Protocol, Src Port: 55349 (55349), Dst Port: 5683 (5683) 
Source Port: 55349 


Destination Port: 2683. UDP 目标 端口 号 
Length: 20 


» Checksum: 0x8183 [validation disabled] 
[Stream index: 2] 
v Constrained Application Protocol, Confirmable, GET, MID:27362 


- Version: 1 
.... = Type: Confirmable (0) 
.... 0000 = Token Length: 0 
Code: GET (1) COAP 请 求 方法 
Message ID: 27362 
v Opt Name: #1: Uri-Path: hello CoAP 请 求 路 由 
Opt Desc: Type 11, Critical, Unsafe 
1011 .... = Opt Delta: 11 
.... 0101 - Opt Length: 5 
Uri-Path: hello 


de 02 50 7b 9d a0 87 8d 08 00 45 00 
00 00 80 11 00 00 cO a8 00 03 cð a8 
16 33 00 14 381 83 40 01 6a e2 b5 68 
c1 01 


图 4-11 Wireshark Z7 Jf 3& Jit hello 3f 7g 33:1. CoAP 请 求 


表达 式 … | + ”应 用 此 过 源 器 
Time Source Destination Protocol Length Info 
5 1.681181 192.168.0.3 192.168.0.10 CoAP 54 CON 
6 1.687122  192.168.0.10 192.168.0.3 CoAP 61 ACK 


> 


> Internet Protocol Version 4, Src: 192.168.0.10, Dst: 192.168.0.3 
v User Datagram Protocol, Src Port: 5683 (5683), Dst Port: 55349 (55349) 
Source Port: 5683 
Destination Port: 55349 
Length: 27 
» Checksum: 0x3818 [validation disabled] 
[Stream index: 2] 
v Constrained Application Protocol, Acknowledgement, 2.05 Content, MID:27362 
Gl.. .... = Version: 1 
.19 .... = Type: Acknowledgement (2) 
0000 = Token Length: 0 


Code: 2.05 Content (69) CoAP 响 应 码 
Message ID: 27362 


» Opt Name: $1: Content-Format: text/plain; charset-utf-8 
End of options marker: 255 
v Payload: Payload Content-Format: text/plain; charset-utf-8, Length: 11 
Payload Desc: text/plain; charset-utf-8 
v Line-based text data: text/plain 


Hello CoAP! CoAP 响 应 负载 


bb cc de 02 08 00 45 00 
78 f2 c0 a8 00 0a cð a8 
38 18 60 45 6a e2 c2 00 
43 6f 41 50 21 ..Hello CoAP! 


图 4-12  Wireshatk Z-J/f 3& Jit hello HR 33:2: CoAP 响 应 


通过 Wireshark 还 可 以 获得 CoAP 请 求 或 响应 的 更 多 细节 ， 本 章 的 入 门 示例 将 不 对 这 些 细节 做 详细 说 明 ， 入 门 示例 希望 帮助 读者 揭 开 CoAP 的 “神秘 面纱 ”， 并 保持 对 CoAP 的 好 奇 心 与 信心 。 


44 ”本 章 小 结 


本 章 通过 一 个 非常 简洁 的 示例 展现 了 CoAP， 在 这 个 入 门 示 例 中 使 用 Firefox 浏 览 器 的 Coppet 播 件 作 为 CoAP 客 户 端 ， 使 用 一 个 带 有 网 络 扩展 板 的 Atduino UNO 作 为 CoAP 服 务 器 。 无 论 是 Coppet 插 件 还 是 
Atrduino 都 非常 容易 上 手 。 入 门 示例 中 CoAP 服 务 器 在 一 个 内 存 只 有 2KB 的 受 限 制 的 暴 入 式 设备 中 实现 ， 那 么 CoAP 服 务 器 或 客户 端 几乎 可 以 在 任何 具有 联网 能 力 的 硬件 中 实现 ， 这 些 硬件 包括 树 莓 派 和 
Beaglebone Black 这 样 的 Linux 主 机 设备 ， 也 包括 那些 具有 IEEE 802.15.4 无 线 射 频 的 SoC。 入 门 示例 的 最 后 使 用 了 Witeshatk 分 析 了 CoAP 请 求 与 CoAP 响 应 ， 在 分 析 过 程 中 出 现 了 CoAP 方 法 、CoAP URI 和 CoAP 响 
应 码 等 名 词 ， 通 过 后 面 几 章 的 学 习 读 者 可 以 很 轻松 地 掌握 这 些 概念 ， 让 我 们 继续 CoAP 之 旅 吧 。 


第 5 草 ”CoAP 核 心 


51 ”本章 主 要 内 容 


本 章 将 学 习 CoAP 的 核心 部 分 内 容 ，CoAP 核 心 部 分 由 《RFC 7252 一 一 The Constrained Appli-cation Protocol (CoAP) [1》 定 义 ， 本 章 以 该 RFC 文 档 为 主线 ， 包 括 以 下 主要 内 容 : 
: CoAP 首 部 分 析 : 版 本 编号 、 报 文 类 型 、 标 签 长 度 指示 、 准 则 、 报 文 序号 、 标 签 、 选 项 、 分 隔 符 和 负载 。 

: CoAP 工 作 模 式 说 明 : CON、NON、ACK 和 RST。 

.CoAP 重 传 机 制 分 析 : CoAP 请 求 丢 失 处 理 、CoAP 响 应 丢失 处 理 、 最 大 重 传 次 数 、 最 大 传输 耗 时 、 最 大 等 待 时 间 。 

:CoAP 方 法 说 明 : GET 方 法 、POST 方 法 、PUT 方 法 和 DELETE 方 法 。 

.CoAP 响 应 码 说 明 : 正确 响应 、 客 户 端 错误 、 服 务 器 错误 。 

: CoAP 选 项 详细 分 析 : 选项 格式 、URI 选 项 、Content-Format 选 项 、Accept 选 项 、EEtag 选 项 、IfMatch 选 项 、IfNone-Match 选 项 。 


: CoAP 媒 体 类 型 说 明 : link-format 类 型 、 文 本 类 型 、 二 进 制 类 型 、JSON 类 型 。 


[1] https:/ /datatracket.ietf.org/doc/tfc7252/ o 


第 5 章 ”CoAP 核 心 


51 ”本章 主 要 内 容 


本 章 将 学 习 CoAP 的 核心 部 分 内 容 ，CoAP 核 心 部 分 由 《RFC 7252 一 一 The Constrained Appli-cation Protocol (CoAP) [11》 定 义 ， 本 章 以 该 RFC 文 档 为 主线 ， 包 括 以 下 主要 内 容 : 
|: CoAP 首 部 分 析 : 版 本 编号 、 报 文 类 型 、 标 签 长 度 指 示 、 准 则 、 报 文 序号 、 标 签 、 选 项 、 分 隔 符 和 负载 。 

. CoAP 工 作 模 式 说 明 : CON、NON、ACK 和 RST。 

: CoAP 重 传 机 制 分 析 : CoAP 请 求 丢失 处 理 、CoAP 响 应 丢失 处 理 、 最 大 重 传 次 数 、 最 大 传输 耗 时 、 最 大 等 待 时 间 。 

: CoAP 方 法 说 明 : GET 方 法 、POST 方 法 、PUT 方 法 和 DELETE 方 法 。 

:CoAP 响 应 码 说 明 : 正确 响应 、 客 户 端 错误 、 服 务 器 错误 。 

: CoAP 选 项 详细 分 析 : 选项 格式 、URI 选 项 、Content-Format 选 项 、Accept 选 项 、Etag 选 项 、If-Match 选 项 、If-None-Match 选 项 。 

: CoAP 媒 体 类 型 说 明 : link-format 类 型 、 文 本 类 型 、 二 进 制 类 型 、JSON 类 型 。 


[1] https:/ /datatracker.ietf.org/doc/tfc7252/ o 


5.2 CoAP 首 部 


与 UDP 和 和 TCP 类似，CoAP 的 学 习 也 应 从 CoAP 首 部 开始 。 与 HTTP 1.X 协 议 不 同 ，CoAP 是 一 个 完整 的 二 进 制 应 用 层 协议 ，CoAP 首 部 包括 版 本 编号 Ver、 报 文 类 型 T、 标 签 长 度 指示 TKL、 准 则 Code、 报 


文 序号 Message ID、 标 签 Token、 选 项 Options、 分 隔 符 0xFF 和 负载 Payload 等 几 个 部 分 。 


其 中 版 本 编号 Ver、 报 文 类 型 T、 标 签 长 度 指示 TKL、 准 则 Code 和 报 文 序号 Message ID 为 必要 部 分 ， 也 就 是 说 这 几 部 分 一 定 会 出 现在 CoAP 请 求 或 响应 中 。 而 标签 Token、 选 项 Options、 分 隔 符 0xFF 和 
负载 Payload 为 非 必要 部 分 ， 这 些 部 分 均 为 可 选 部 分 。CoAP 首 部 结构 如 图 5-1 所 示 。 


0 S 16 24 3 
Token ( 如 果 存 在 ) 
Options ( 如 有 果 存 在 ) 


2 


Payload (如 条 存在 ) 


图 5-1 CoAP 首 部 结构 


5.2.1 版 本 编号 Ver 


CoAP 版 本 编号 区 域 占 2 位 。 在 RFC 7252 规 范 中 该 区 域 必须 为 固定 值 0b01。 


5.2.2. 报 文 类 型 


CoAP 报 文 类 型 区 域 占 2 位 。CoAP 中 共 定义 了 4 种 不 同 的 报 文 类 型 ,分别 是 : 
: Confirmable: 需要 被 确认 的 报 文 ， 简称 CON 报 文 ， 此 时 T=0b00。 

: Non-Confirmable: 不 需要 被 确认 的 报 文 ， 简 称 NON 报 文 ， 此 时 T=0b01。 
* Acknowledgement: 应 答 报 文 ， 简称 ACK 报 文 ， 此 时 T=0b10。 

: Reset: 复位 报 文 ， 简称 RST 报 文 ， 此 时 T=0b11。 


在 HTTP 中 ， 一 个 HTTP 请 求 对 应 一 个 HTTP 响 应 ; 但 在 CoAP 中 ， 如 果 CoAP 客 户 端 发 送 NON 类 型 的 CoAP 请 求 ， 那 么 CoAP 服 务 器 可 选择 不 返回 CoAP 响 应 。 换 句 话 说 ，CoAP 客 户 端 并 不 关心 请 求 是 否 
到 达 CoAP 服 务 器 。NON 类 型 报 文 是 CoAP 中 的 一 个 “特色 ”， 通 过 这 种 设计 人 允许 设备 犯 “ 错 ”。 


5.2.3 ”标签 长 度 指 示 TKL 


CoAP 标 签 长 度 指示 TKL 占 4 位 ， 该 区 域 用 于 指示 CoAP 标 签 区 域 的 具体 长 度 。 由 于 COoAP 是 一 个 二 进 制 协议 ， 对 于 非 固定 长 度 的 区 域 都 需要 长 度 指 示 。COAP 报 文中 可 以 包含 CoAP 标 签 也 可 以 省 略 CoAP 
标签 。 若 CoAP 报 文中 省 略 CoAP 标 签 ， 那 么 此 时 的 TKL=0b0000; 若 CoAP 报 文中 包含 CoAP 标 签 ， 那 么 TKL 的 取 值 可 以 为 0b0001 (1) 、0b0010 (2) 或 0b0100 (4) 。 图 5-2a 中 TKL=0b0001 (1) 
时 ，Token 区 域 包含 长 度 为 1 字 节 的 内 容 ; 图 5-2b 中 TKL=0b0100 (4) 时 ，Token 区 域 包含 长 度 为 4 字 节 的 内 容 。 


TKL=0b0001，Token 区 域 包含 长 度 为 1 字 节 的 内 容 


Token 


Options( 如 果 存 在 ) 


Payload ( 如 果 存 在 ) 


a) 


TKL=0b0100，Token 区 域 包 含 长度 为 4 字 方 的 内 容 


Token 


Options ( 如 果 存 在 ) 


Payload ( 如 采 存 在 ) 


b) 


图 5-2 ”标签 长 度 指 示 TKL 示 例 


5.2.4 准则 Code 


CoAP 准 则 占 1 字 节 (8 位 ) 。 虽 然 该 区 域 仅 占 8 位 ， 但 该 区 域 在 CoAP 请 求 和 响应 报 文 中 却 包 含 了 大 量 有 用 信息 。Code 部 分 分 为 高 3 位 Class 部 分 和 低 5 位 Detail 部 分 。 为 了 更 方便 地 描述 和 表达 ，Code 部 
分 采用 c.dd 的 形式 描述 ， 其 中 c 的 取 值 学 围 为 0~ 7，dd 的 取 值 范 围 为 0~31。“c” 部 分 和 “dd” 部 分 均 采 用 十 进 制 形式 描述 。 当 c 等 于 0 时 表示 CoAP 请 求 ， 当 c 不 等 于 0 时 表示 CoAP 响 应 。 


1.CoAP 请 求 


在 CoAP 请 求 报 文 中 Code 区 域 用 于 指示 CoAP 请 求 方法 ，CoAP 请 求 方法 和 HTTP 请 求 方法 非常 相似 ，CoAP 中 共有 4 种 不 同 的 请 求 方法 一 一 GET 方 法 、POST 方 法 、PUTT 方 法 和 DELETE 方 法 。 
- Code=0.01 表 示 GET 方 法 

- Code=0.02 表 示 POST 方 法 

: Code=0.03 表 示 PUT 方 法 


: Code=0.04 表 示 DELETE 方 法 


与 HTTP 不 同 ，CoAP 协 议 使 用 二 进 制 方式 表示 请 求 方法 ， 无 论 如 何 这 些 请 求 方法 仅 占 1 字 节 ， 而 在 HTTP 中 请 求 方法 采用 字符 串 形式 表达 ，“GET” 占 3 字 节 ，“POST” 占 4 字 节 。CoAP 通 过 这 样 的 设计 
方式 既 缩短 了 CoAP 首 部 长 度 又 与 HTTP 协 议 保持 相同 的 请 求 语义 


2.CoOAP 响 应 
CoAP 响 应 报 文 中 Code 区 域 用 于 指示 CoAP 响 应 状态 。CoAP 响 应 码 和 HTTP 中 的 状态 码 非常 相似 ，CoAP 中 定义 了 4 种 不 同类 型 的 响应 报 文 一 一 空 报 文 、 正 确 响应 、 客 户 端 错误 响应 和 服务 器 错误 响应 。 


Code=0.00 表 示 空 报 文 


Code=2.xx 表 示 正 确 响 应 
:Code=4.xx 表 示 客 户 端 错误 响应 
Code=5.xx 表 示 服 务 器 错误 响应 


空 报 文 是 一 种 特殊 形式 的 CoAP 响 应 ， 在 空 报 文中 只 有 CoAP 首 部 而 没有 CoAP 负 载 ， 且 Code 区 域 始终 为 0.00。 与 CoAP 请 求 方法 的 设计 原理 相似 ，CoAP 响 应 码 也 与 HTTP 状 态 码 保持 相似 的 语义 ， 如 
HTTP 中 2XX 表 示 正 确 响应 ， 而 CoAP 中 2.xx 也 表示 正确 响应 。 在 CoAP 中 ，2.05 Content 与 HTTP 200 OK 的 含义 几乎 相同 ， 但 是 CoAP 中 表示 成 功 仅 占 1 字 节 ，HTTP 中 “200 OK” 却 占 6 字 节 


5.2.5 ” 报 文 序号 Message ID 


CoAP 报 文 序 号 占 2 字 节 ， 并 采用 大 端 格式 描述 。 由 于 CoAP 采 用 UDP 作 为 传输 层 协 议 ，UDP 不 能 保证 CoAP 报 文 的 到 达 顺 序 。 如 果 没有 报 文 序号 ， 那 么 无 论 客户 端 还 是 服务 器 都 无 法 建立 报 文 之 间 准 确 
的 一 一 对 应 关系 。CoAP 中 规定 ， 一 组 对 应 的 CoAP 请 求 和 CoAP 响 应 必须 使 用 相同 的 Message ID, 


5.2.6 标签 Token 


标签 是 一 个 长 度 可 变 的 区 域 ， 该 区 域 的 长 度 由 TKL 定 义 ， 一般 为 1 字 节 、2 字 节 或 4 字 节 。 在 CoAP 中 ， 标 签 可 以 理解 为 男 一 种 形式 的 报 文 序号 。CoAP 中 定义 了 两 种 不 同形 式 的 请 求 /响应 工作 模式 : 一 种 
为 携带 模式 ; 另 一 种 为 分 离 模式 。 标 签 在 分 离 模式 中 发 挥 重 要 的 作用 ， 但 在 携带 模式 中 往往 可 以 省 略 。 


5.2.7 Options 


COAP 请 求 或 响应 中 可 携带 一 组 或 多 组 CoAP 选 项 ，CoAP 选 项 和 HTTP 中 的 通用 首部 字段 、 请 求 首 部 字段 、 响 应 首部 字段 和 实体 首部 字段 功能 相似 。CoAP 选 项 是 CoAP 核 心 协议 中 较为 复杂 的 部 分 ， 但 选 
分 也 给 CoAP 的 应 用 带 来 了 诸多 灵活 性 。CoAP 选 项 包括 Uri-Host、Uri-Port、Uri-Path、Uri-Query、Content-Format、Accept、Etag、If-Match 和 If-None-Match 等 部 分 。 


5.2.8 ”分 隔 符 OxFF 
CoAP 首 部 和 CoAP 负 载 之 间 使 用 固定 分 隔 符 0xFF， 占 1 字 节 。 在 HTTP 中 ，HTTP 首 部 和 负载 之 间 也 有 一 个 显 式 的 分 隔 标 记 一 — 空 行 ( 回 车 与 换行 ， 共 占 2 字 节 ) 。CoAP 中 也 保留 了 类 似 的 分 隔 符 ， 在 
CoAP 首 部 的 其 他 部 分 并 没有 首部 长 度 的 指示 ， 且 首部 长 度 也 不 是 一 个 固定 值 ， 那 么 就 需要 0xFF 这 样 的 固定 分 隔 符 区 分 CoAP 首 部 和 CoAP 负 载 。 


在 一 个 具有 CoAP 负 载 的 报 文 中 ， 固 定 分 隔 符 将 会 出 现在 标签 Token 或 者 CoAP 选 项 Options 之 后 。 如 果 固 定 分 隔 符 出 现在 标签 Token 之 后 ， 由 于 CoAP 首 部 中 有 标签 长 度 指示 ， 即 使 标签 Token 区 域 中 最 
后 一 字 节 为 0xFF 也 不 会 影响 报 文 的 解析 ; 如 果 固 定 分 隔 符 出 现在 选项 Options 之 后 ， 由 于 每 个 单独 的 选项 也 具有 长 度 指示 ， 那 么 即使 最 后 一 个 选项 以 0xFF 结 尾 也 不 会 影响 报 文 解析 。 在 上 述 两 种 极端 情况 
下 ， 将 在 CoAP 报 文中 连续 出 现 两 个 0xFF， 但 不 会 影响 报 文 的 相关 解析 。 


在 图 5-3 中 ，Token 区 域 的 最 后 一 个 字符 为 0xFF， 在 CoAP 报 文中 连续 出 现 了 两 个 0xFF， 但 由 于 TKL 指 示 Token 区 域 的 长 度 为 4 字 节 ， 通 过 TKL 就 可 以 正确 识别 出 哪 一 个 0xFF 属 于 Token 区 域 ， 哪 一 个 
0xFF 属 于 CoAP 首 部 与 CoAP 负 载 之 间 的 分 隔 符 


| 长 度 指 示 
Wi: 
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OxFF Payload 


图 5-3 ”连续 出 现 两 次 0xFF 的 极端 情况 


5.2.9 ”负载 Payload 


CoAP 负 载 包含 与 具体 应 用 直接 相关 的 内 容 。CoAP 负 载 包含 多 种 不 同 的 媒体 类 型 ， 包 括 二 进 制 负载 、 文 本 负载 、XML 负 载 、JSON 负 载 、CBOR 负 载 等 。CoAP 所 支持 的 媒体 类 型 中 并 不 包括 HTML 类 
型 ， 换 句 话 说 CoAP 并 不 包含 与 网 页 相关 的 内 容 ， 这 点 与 HTTP 存 在 很 大 的 区 别 。 


5.3 ”CoAP 工 作 模式 


CoAP 虽 然 参考 了 HTTP 的 设计 思路 ,但 也 根据 受 资源 限制 设备 的 具体 情况 改良 了 诸多 设计 细节 ， 同 时 增加 了 很 多 实用 功能 。 本 节 分 为 三 部 分 内 容 一 一 逻辑 分 层 结构 、 报 文 类 型 和 请 求 /响应 模式 .。 


5.3.1 ”逻辑 分 层 结构 


CoAP 的 数据 交互 方式 和 HTTP 的 请 求 /响应 工作 方式 非常 相似 。CoAP 请 求 一 般 由 客户 端 发 起 ， 服 务 器 根据 客户 端 请 求 中 的 URI 定 位 资源 在 服务 器 中 的 具体 位 置 ， 通 过 客户 端 请 求 中 的 请 求 方法 确定 如 何 
操作 该 资源 ， 如 读 取 资 源 、 创 建 资源 、 修 改 资 源 或 者 删除 资源 等 。CoAP 服 务 器 处 理 请 求 之 后 将 返回 一 个 CoAP 响 应 ，CoAP 响 应 中 包含 响应 码 ， 也 有 可 能 包含 响应 负载 。 


与 HTTP 采 用 TCP 作 为 传输 层 不 同 ，CoAP 使 用 UDP 作 为 传输 层 协 议 。UDP 并 不 是 一 个 面向 连接 的 传输 层 协议 ， 所 以 CoAP 定 义 4 种 不 同 的 报 文 类 型 : CON (Confirmable) , NON (Non- 
Confirmable) 、ACK (Acknowledgement) 和 RST (Reset) , ET 消息 层 和 请 求 /响应 层 。 消 息 层 处 理 端 点 之 间 的 数据 交换 ， 并 为 CON、NON、ACK 和 RST 报 文 类 型 
提供 重 传 机 制 ，CoAP 通 过 增加 消息 层 的 方式 弥补 UDP 传输 的 不 可 靠 性 。CoAP 的 逻辑 分 层 结构 如 图 5-4 所 示 。 


LH 


CON 报 文 NON 报 文 
ACK 报 文 RST 报 文 


传输 层 


图 5-4  CoAPTI-BUE £t 2544 


5.3.2” 报 文 类 型 


CoAP 定 义 了 四 种 不 同 的 报 文 类 型 ， 通 过 这 四 种 不 同 的 报 文 类 型 至 少 可 以 组 合成 可 靠 传输 和 非 可 靠 传输 两 种 工作 方式 。 
1.4 种 报 文 类 型 


: Confirmable Message (CON) : 在 请 求 /响应 交互 过 程 中 ，CON 报 文 需要 被 接收 者 确认 。 每 一 个 CON 报 文 必须 要 对 应 一 个 准确 的 ACK 报 文 或 RST 报 文 ， 如 果 在 规定 的 时 间 内 容 户 端 未 接收 到 ACK 报 文 或 
RST 报 文 ， 那 么 客户 端 将 会 触发 一 次 “ 重 传 ”。 


: Non-Confirmable Message (NON) : 相 比 于 CON 报 文 ， NON 报 文 的 约束 条 件 要 宽松 许多 。 单 个 NON 报 文 不 需要 对 应 一 个 准确 的 ACE 或 RST 报 文 。 在 一 些 传感器 数据 上 传 应 用 场景 中 NON 报 文 较为 常 
用 ， 服 务 器 对 NON 报 文 的 处 理 也 较为 灵活 。 若 服务 器 收 到 一 个 来 自 客户 端的 NON 报 文 类 型 的 CoAP 请 求 ， 服 务 器 可 选择 不 返回 响应 ; 同时 客户 端 也 不 会 因为 一 定时 间 内 没有 收 到 来 自 服务 器 的 ACK 类 型 报 文 
而 触发 重 传 机 制 。 


* Acknowledgement Message (ACK) : ACK 报 文 用 于 确认 CON 报 文 。ACK 报 文 的 报 文 序号 (Message ID) 需要 和 CON 报 文 的 报 文 序号 保持 严格 一 致 ，ACK 报 文 可 以 在 一 定 程度 上 保证 CoAP 传 输 的 可 靠 
性 。ACK 报 文中 可 以 不 包括 响应 负载 ， 可 能 为 空 。CoAP 请 求 / 响 应 过 程 定 义 了 携带 模式 和 分 离 模式 ，ACK 报 文 负 载 为 空 的 情况 一 般 出 现在 分 离 模式 中 。 


: Reset Message (RST) : 若 服务 器 接收 到 一 个 CON 报 文 ， 但 由 于 报 文 中 上 下 文 缺 失 导 致 服务 器 无 法 处 理 该 报 文 ， 那 么 服务 器 将 会 返回 一 个 RST 报 文 。RST 报 文 的 报 文 序号 需要 与 CON 报 文 的 报 文 序号 保 
持 严格 一 致 ， 而 且 RST 报 文 的 负载 一 


2. 可 靠 传输 
由 于 CoAP 使 用 UDP 作为 传输 层 协 议 ，UDP 并 不 是 一 种 面向 连接 的 传输 层 协 议 ， 所 以 对 于 一 些 要 求 可 靠 传输 的 场合 ，CoAP 需 要 另外 增加 某 种 机 制 保证 传输 的 可 靠 性 。 


CON 报 文 和 ACK 报 文 可 保证 CoAP 请 求 /响应 交互 过 程 的 可 靠 性 。 当 客户 端 发 送 一 个 CON 报 文 时 ， 报 文 的 接收 者 必须 返回 一 条 ACK 报 文 来 确认 其 已 经 正确 收 到 了 该 CON 报 文 。 需 要 特别 指出 ，CON 报 文 
中 的 Message ID 必须 与 ACK 报 文中 的 Message 1D 完 全 一 致 。 在 图 5-5 中 ，COAP 客 户 端 发 送 一 个 CON 报 文 ， ee ID 为 0x7d34， 接 收 者 收 到 该 CON 报 文 之 后 返回 一 个 ACK 报 文 ，ACK 报 文 的 
Message 1D 同 为 0x7d34。 


CoAP 客 户 端 CoAPJIE I AF 


CON[0x7d34] 


ACK[0x7d34] 


图 5-5 ”CoAP 可 人 靠 传输 示例 


若 客户 端 在 一 定 的 时 间 内 没有 收 到 ACK 报 文 ， 那 么 客户 端 将 重新 发 送 CON 报 文 。CoAP 重 传 机 制 也 可 提高 CoAP 的 可 靠 性 ，CoAP 重 传 机 制 通过 两 个 主要 的 参数 进行 控制 
器 ，COoAP 重 传 机 制 将 在 5.4 节 详细 分 析 。 


超时 时 间 和 重 传 计数 


3. 非 可 靠 传输 


在 物 联 网 应 用 领域 并 不 是 所 有 的 发 送 者 报 文 都 需要 被 确认 。NON 报 文 是 一 种 非常 轻 量 级 的 替换 方案 。 如 图 5-6 所 示 便 是 一 个 非 可 靠 传输 示例 ，CoAP 客 户 端 发 送 一 条 NON 报 文 ，NON 报 文 的 Message 
ID 为 0x01a0， 而 服务 器 什么 都 没有 返回 。 


CoAPHE AS AY 


: NON[0x0120] | 


图 5-6 ”CoAP 非 可 靠 传输 示例 


5.3.3 “请求 /响应 模式 


虽然 COAP 参 考 了 很 多 HTTP 的 优秀 特性 ， 但 在 具体 实现 过 程 中 仍 和 HTTP 存 在 区 别 。 在 CoAP 中 包含 至 少 三 种 不 同 的 请 求 /响应 工作 模式 一 一 携带 模式 、 分 离 模式 和 非 确认 模式 ， 其 中 携带 模式 和 HTTP 中 
的 请 求 /响应 模式 最 为 相近 。 下 面 通过 一 个 获取 温度 传感器 检测 结果 的 示例 说 明 携 带 模 式 、 分 离 模 式 和 非 确认 模式 的 区 别 和 联系 。 从 5.2 节 中 可 获知 ，CoAP 首 部 中 一 定 存在 报 文 序号 Message ID 区域， 该 区 
域 占 2 字 节 ， 而 在 COAP 首 部 中 Token 区 域 为 可 选择 项 ， 其 内 容 和 长 度 均 由 应 用 决定 。 在 本 小 节 的 示例 中 ， 包 含 以 下 假定 条 件 : 


假定 Token 的 长 度 为 1 字 节 。 
- 假设 温度 传感器 在 服务 器 的 资源 URI 为 “tempetrature”。 
| 通过 GET 方 法 可 获取 温度 传感器 检测 结果 。 
“ 检测 结果 采用 文本 格式 表示 。 

1. 携 带 模式 


在 图 5-7 中 ，CoAP 客 户 端 发 送 一 次 GET 请 求 ， 该 请 求 采用 CON 报 文 格 式 ， 报 文 序 号 Message ID 为 0xbc90，Token 为 0x71; CoAP 服 务 器 接收 到 GET 请 求 之 后 返回 ACK 报 文 ，ACK 报 文 的 响应 码 
为 “2.05”， 表 示 服 务 器 正确 处 理 请 求 并 返回 正确 响应 ，ACK 报 文 的 Message ID 和 Token 与 GET 请 求 中 的 Message ID 和 Token 完 全 相同 。 此 时 ACK 报 文中 包含 响应 负载 ， 响 应 负载 为 文本 形式 。 


CoAPHE A 28 


CONL[O0xbc90] 
GET /temperature 
(Token 0x71) 


ACK[0xbc90 | 
2.05 Content 

(Token 0x71) 
prb ud 


E5-7 ”携带 模式 下 的 GET 请 求 与 响应 


携带 模式 可 简单 理解 为 ACK 报 文中 包含 响应 负载 ， 例 如 此 处 的 温度 传感器 检测 结果 一 一 “22.5 C” (字符 串 形 式 描 述 ) 。 携 带 模式 是 最 常用 的 请 求 /响应 工作 模式 ， 在 这 种 工作 模式 下 ，Message ID 和 
Token 的 作用 几乎 相同 。 为 了 减少 CoAP 报 文 长 度 ， 更 多 的 情况 下 只 使 用 Message ID 便 可 。 
2. 分 离 模 式 


在 图 5-8 中 ，CoAP 客 户 端 发 送 一 次 GET 请 求 ， 该 请 求 同 样 采 用 CON 报 文 格式 ，Message ID 为 0x7a10，Token 为 0X73; CoAP 服 务 器 接收 到 GET 请 求 之 后 立刻 返回 ACK 报 文 ， 但 ACK 报 文中 并 没有 包含 
任何 响应 负载 。 一 段 时 间 之 后 ， 服 务 器 再 向 客户 端 发 送 一 个 CON 报 文 ， 该 报 文 的 Message 1D 为 0x23bb，Token 为 0x73， 该 CON 报 文 的 响应 码 为 “2.05”， 表 示 服 务 器 正确 处 理 请 求 并 返回 正确 响应 。 该 
CON 报 文中 还 包括 响应 负载 ， 响 应 负载 为 文本 形式 的 “22.5 C”。 客 户 端 收 到 CON 报 文 之 后 ， 返 回 一 个 ACK 报 文 进行 确认 。 
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CON[O0x7a10| 
GET /temperature 
(Token 0x73) 


| CONL[O0x23bb] | 
! 2.05 Content ! 
\ (Token 0x73) 
\ Piei Gi | 


图 5-8 ”分 离 模式 下 的 GET 请 求 与 响应 


分 离 模 式 中 总 共产 生 两 组 CON 报 文科 ACK 报 文 。 相 比 于 携带 模式 ， 分 离 模式 需要 进行 4 次 交互 ， 而 携带 模式 只 需要 2 次 交互 。 此 处 4 次 交互 过 程 中 产生 了 两 个 Message ID 一 一 0x7a10 和 0x23bb， 但 仪 包 
括 一 个 Token 一 一 0x73， 通 过 这 个 例子 也 可 以 看 出 Message ID 和 Token 的 区 别 ，Message ID 更 多 地 用 于 报 文 确认 ， 而 Token 带 有 更 多 的 “应 用 ”含义 ， 可 以 理解 为 应 用 确认 。CoAP 客 户 端 试图 获取 温度 
传感器 资源 ， 使 用 一 个 Token “标记 ”该 应 用 动作 ， 而 CoAP 服 务 器 返回 温度 传感器 检测 结果 时 再 把 该 Token “标记 ”到 响应 内 容 中 ， 这 样 CoAP 客 户 端 就 可 以 通过 该 Token 识 别 应 用 动作 。 


3. 非 确认 模式 


非 确认 模式 是 CoAP 中 最 为 松散 的 请 求 / 响 应 工作 模式 。 在 图 5-9 中 ，CoAP 客 户 端 发 送 一 次 GET 请 求 ， 但 该 报 文 并 不 是 CON 报 文 ， 而 是 一 个 并 不 需要 确认 的 NON 报 文 。CoAP 服 务 器 接收 到 该 NON 报 文 
之 后 ， 同 样 返回 一 个 NON 报 文 。 非 确认 模式 的 其 他 部 分 与 携带 模式 、 分 离 模式 非常 相似 。 
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NON[0x7a11] 
GET /temperature 
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NON[0x23bc] 
2.05 Content 
(Token 0x74) 
“22.5 C” 


图 5-9 JEANA 


54 ”CoAP 重 传 机 制 


在 网 络 数据 传输 过 程 中 ， 无 论 是 CoAP 请 求 还 是 CoAP 响 应 均 可 能 产生 丢失 。CoAP 为 了 保证 传输 的 可 靠 性 还 设计 了 重 传 机 制 。 


5.4.1 CoAP 重 传情 况 分 析 


分 析 CoAP 重 传 机 制 之 前 我 们 先 来 分 析 网 络 数据 传输 过 程 中 丢失 的 情况 。 对 于 CoAP 来 说 网 络 数据 丢失 可 分 为 两 种 情况 一 一 CoAP 请 求 丢 失 和 CoAP 响 应 丢失 。 


1.CoAP 请 求 丢 失 


CoAP 请 求 丢 失 的 情况 如 图 5-10 所 示 。 在 描述 的 场景 中 ，CoAP 客 户 端 试图 获取 temperature 资 源 。 在 某 时 刻 CoAP 客 户 端 发 起 GET 请 求 ， 但 是 该 CoAP 请 求 并 没有 如 客户 端 预期 那样 准确 到 达 CoAP 服 务 
器 ， 在 请 求 的 传输 过 程 中 报 文 意外 丢失 。 通 过 5.3 节 可 以 获知 ，CoApP 请 求 分 为 CON 类 型 和 NON 类 型 ， 若 请 求 为 CON 类 型 那么 客户 端 必须 等 待 来 自 服务 器 的 响应 ， 若 在 规定 的 时 间 内 没有 收 到 响应 那么 客户 
端 便 会 认为 请 求 失败 。 在 如 图 5-10 所 示 的 场景 中 ， 客 户 端 发 送 了 CON 类 型 的 请 求 但 是 在 一 定 的 时 间 内 没有 收 到 服务 器 的 响应 ， 那 么 客户 端 将 会 重新 发 送 CoAP 请 求 ， 而 且 两 次 CoAP 请 求 的 首部 和 负载 完全 
相同 。 


2.COAP 响 应 丢失 


除了 CoAP 请 求 丢 失 的 情况 之 外 ，CoAP 客 户 端 还 需要 处 理 响 应 丢失 的 情况 。 如 图 5-11 所 示 便 是 典型 的 CoAP 响 应 丢失 场景 。CoAP 客 户 端 坛 图 获取 服务 器 中 的 temperature 资 源 ， 它 向 服务 器 发 送 CON 
类 型 的 GET 请 求 ， 服 务 器 正常 返回 了 响应 但 该 响应 没有 正确 到 达 客 户 端 。 对 于 客户 端 来 说 ， 由 于 在 规定 时 间 内 没有 收 到 响应 ， 那 么 前 一 次 COAP 请 求 将 会 判定 为 失败 。 为 了 正确 获取 temperature 资 源 ， 客 户 
端 不 得 不 再 次 发 送 CoOAP 请 求 ， 而 且 两 次 的 CoAP 请 求 完 全 一 致 。 此 时 CoAP 服 务 器 只 能 “不 厌 其 烦 ”地 返回 相同 的 内 容 。 


客户 端 判 定 请 求 
失败 ， 重 新 传输 


CON[0x7d36] 
GET /temperature 


(Token 0x31) ) 


GET /temperature 
(Token 0x31) 


CON[0x7d36] ' 
ACK[0x7d36] 
2.05 Content ! 
(Token 0x31) | 
Be b ! 


图 5-10 请求 丢失 


CoAP 客 户 端 CoAPJI $2 


CON[0x7437] 
GET /temperature 
(Token 0x42) 


ACK[0x7d37 | 
2.05 Content 
(Token 0x42) 


ADR 
-划一 


CON[0x7d37] 
GET /temperature 
(Token 0x42) 


$t Em AEIBAK ACK[0x7d37] 


失败 ， 重 新 传输 2.05 Content 
B : (Token 0x42) 


22 5 C 


图 5-11 响应 丢失 


5.4.2 ”传输 参数 说 明 


通过 前 面 的 分 析 可 以 获知 CoAP 请 求 和 响应 均 有 丢失 的 风险 ， 为 了 解决 该 问题 ，CoAP 客 户 端 需要 重新 发 送 CoAP 请 求 。CoAP 报 文 重 传 一 般 由 ACK_TIMEOUT、ACK_RANDOM_FACTOR 和 
MAX_RETRANSMIT 三 个 参数 控制 。CoAP 传 输 参数 见 表 5-1。 


表 5-1 CoAP 传 输 参数 


参数 名 称 说 BH Bm 型 值 
ACK TIMEOUT 响应 等 待 超时 时 间 2 秒 


ACK RANDOM FACTOR 随机 系数 1.5 
MAX RETRANSMIT 最 大 重 传 次 数 4 


如 果 CoAP 客 户 端 首次 发 送 CON 报 文 之 后 ， 在 ACK_TIMEOUT 到 ACK_TIMEOUT*ACK_RANDOM_FACTOR 时 间 内 仍 没 有 收 到 ACK 报 文 或 者 RST 报 文 ， 那 么 CoAP 客 户 端 将 重新 发 送 一 次 CON 报 文 。 
ACK_TIMEOUT 的 典型 值 为 2 秒 。ACK_RANDOM_FACTOR 是 一 个 不 能 小 于 1.0 的 随机 数 ， 该 参数 的 典型 值 为 1.5。MAX_RETRANSMIT 定 义 最 大 重 传 次 数 ， 该 参数 的 典型 值 为 4。 在 极端 情况 下 ，CoAP 客 户 
端 将 会 执行 4 次 重 传 ， 加 上 第 一 次 CON 报 文 ， 总 共 将 产生 5 次 CoAP 请 求 。 


CoAP 重 传 机 制 由 超时 时 间 和 | 重 传 计数 器 两 个 参数 控制 。 对 于 一 个 CON 报 文 来 说 ， 初 始 的 超时 时 间 为 ACK_TIMEOUT 到 ACK_TIMEOUT*ACK_RANDOM _FACTOR 之 间 的 随机 数 ， 如 果 ACK_TIMEOUT 
采用 典型 值 2 秒 ，ACK_RANDOM _FACTOR 采 用 典型 值 1.5， 那 么 初始 超时 为 2~ 3 秒 ， 如 2.45 秒 、2.95 秒 都 是 合理 的 初始 超时 时 间 。 重 传 计数 器 从 0 开始 递增 ， 一 旦 在 规定 的 时 间 内 没有 收 到 ACK 报 文 或 RST 
报 文 ,那么 CON 报 文 将 会 被 重新 发 送 ， 重 传 计数 器 自动 增加 。 下 一 次 重 传 超时 时 间 为 上 一 次 超时 时 间 的 两 售 ， 如 初始 重 传 时 间 为 2.45 秒 ， 那 么 第 一 次 重 传 的 超时 时 间 为 4.90 秒 。 在 CoAP 协 议 中 重 传 超时 时 
间 将 越 来 越 大 。 


我 们 通过 一 个 更 加 有 具体 的 例子 说 明 CoAP 重 传 机 制 ， 假 设 ACK_TIMEOUT 取 值 为 2，ACK_RANDOM_FACTOR 取 值 为 1.3，MAX_RETRANSMIT 取 值 为 4， 那 么 超时 等 待 时 间 见 表 5-2。 


表 5-2 超时 等 待 时 间 计 算 示 例 


第 n 次 等 待 超时 等 待 时 间 / 秒 
第 1 次 等 待 2X1.3—2.6 

第 2 次 等 待 2X2465—5 

第 3 次 等 待 2xX5.2 10.4 

第 4 次 等 待 2X10.4—20.8 
第 5 次 等 待 2X20.8—41.6 


5.4.3 ”最 大 传输 耗 时 (MAX TRANSMIT SPAN) 


假设 ACK_TIMEOUT 采 用 典型 值 2 秒 ，ACK_RANDOM_FACTOR 采 用 典型 值 1.5，MAX_RETRANSMIT 同 样 采用 典型 值 4， 超 时 重 传 时 间 的 初始 值 采 用 随机 结果 的 上 限 也 就 是 
ACK_TIMEOUT*MAX_RETRANSMIT。 最 糟糕 的 情况 下 ，CoAP 客 户 端 传输 一 次 正常 的 CON 报 文 并 且 重 传 4 次 CON 报 文 ， 在 该 过 程 中 相 邻 CON 报 文 的 时 间 间 隔 分 别 为 ACK_TIMEOUT*1.5、 
2x*ACK TIMEOUT*1.5、4*ACK_TIMEOUT*1.5、8*ACK_TIMEOUT*1.5， 总 计时 间 为 : 


MAX TRANSMIT SPAN =ACK TIMEOUT*1.5* (1+2+4+8) -45 ( 秒 ) 


图 5-12 可 以 很 好 地 说 明 该 重 传 过 程 。CoAP 中 最 大 传输 耗 时 的 典型 值 为 45 秒 ， 在 实际 使 用 过 程 中 ， 由 于 ACK_RANDOM_FACTOR 为 一 个 1 ~ 1.5 之 间 的 随机 值 ， 所 以 最 大 传输 耗 时 往往 小 于 45 秒 。 


CoAP 客 户 端 CoAP 服 务 需 


CON 


ACK TIMEOUT*I1.5 : 
: CON (第 1 次 重 传 ) 


2*ACK TIMEOUT*1.5 
CON (第 2 次 重 传 ) 


4*ACK_TIMEOUT*1.5 
CON (第 3 次 重 传 ) 


MAX TRANSMIT SPAN 


MAX TRANSMIT WAIT 


8*ACK TIMEOUT*I.5 : 
| CON (第 4 次 重 传 ) 


16*ACK TIMEOUT*1.5 


图 5-12 ”CoAP 重 传 机 制 说 明 


5.4.4. ”最 大 等 竺 时间 (MAX TRANSMIT WAIT) 

当 CoAP 客 户 端 执行 最 后 一 次 重 传 之 后 并 不 意味 着 整个 传输 过 程 已 经 结束 ，CoAP 客 户 端 还 需要 等 待 最 后 一 次 超时 时 间 。 最 后 一 次 超时 时 间 为 16*ACK_TIMEOUT*1.5， 那 么 从 CoAP 客 户 端 发 送 第 一 次 
CON 报 文 到 最 后 结束 等 待 总 共 消 耗 的 时 间 为 : 

MAX TRANSMIT WAIT = ACK TIMEOUT*1.5* (1+2+4+8+16) =93 ( 秒 ) 


图 5-12 可 以 说 明 最 大 传输 耗 时 (MAX_TRANSMIT_SPAN) 与 最 大 等 待 时 间 (MAX TRANSMIT WAIT) 之 间 的 联系 与 区 别 。 


55 ”CoAP 方 法 


CoAP 共 有 四 种 不 同 的 请 求 方 法 : GET 方 法 、POST 方 法 、PUT 方 法 和 DELETE 方 法 。 每 一 个 不 能 被 服务 器 识别 或 未 被 服务 器 支持 的 方法 通常 会 导致 一 个 4.05 响 应 码 。 


5.5.1 GET 


GET 方 法 用 于 查询 资源 ， 该 资源 通过 请 求 中 的 URI 进 行 识别 。 由 于 单个 资源 服务 器 可 能 使 用 不 同 的 媒体 类 型 展示 某 资 源 ， 所 以 GET 请 求 中 可 包括 一 个 或 多 个 Accept 选 项 用 于 指示 客户 端 期 望 获得 的 媒体 
类 型 。 若 GET 请 求 被 正确 执行 ，2.05 (Content) 或 2.03 (Valid) 响应 码 将 会 出 现在 CoAP 响 应 报 文 中 。 无 论 是 在 HTTP 应 用 中 还 是 在 CoAP 应 用 中 ，GET 总 是 最 常用 的 方法 。 


5.5.2 POST 


POST 方法 要 求 CoAP 请 求 中 的 资源 描述 内 容 被 CoAP 服 务 器 处 理 。 如 果 POST 请 求 被 正确 执行 ， 那 么 在 服务 器 上 将 创建 一 个 新 资源 。 一 旦 在 服务 器 上 创建 一 个 新 资源 ， 服 务 器 返回 的 响应 中 将 包括 一 个 
2.01 (Create) 响应 码 并且 响 应 负载 中 包括 一 个 新 建 资源 的 URI， 该 URI 可 使 用 一 个 或 多 个 Location-Path 和 Location-Query 定 义 。 如 果 POST 请 求 被 成 功 执行 但 未 在 服务 器 上 创建 新 资源 ， 那 么 响应 消息 中 
应 包含 一 个 2.04 (Changed) 响应 码 ; 如果 POST 请 求 被 成 功 执行 但 导致 服务 器 上 的 目标 资源 被 删除 ， 那 么 响应 消息 中 应 包含 一 个 2.02 (Deleted) 响应 码 。 


55,3. PUT 


PUT 方法 要 求 服务 器 根据 CoAP 请 求 中 的 URI 和 CoAP 请 求 负载 中 的 资源 描述 信息 更 新 服务 器 内 的 指定 资源 。 如 果 资 源 已 经 存在 ， 那 么 服务 器 将 会 更 新 指定 资源 ， 同 时 返回 一 个 包含 2.04 (Changed) 响 
应 码 的 CoAP 响 应 ; 如 果 资 源 不 存在 ， 那 么 服务 器 将 会 根据 请 求 中 的 URI 创 建 一 个 新 的 资源 ， 同 时 返回 一 个 包含 2.01 (Created) 响应 码 的 CoAP 响 应 。 如 果 该 资源 既 不 能 被 创建 也 不 能 被 更 新 ， 那 么 服务 器 将 
返回 一 个 合适 的 错误 响应 码 。 


2.2.4 DELETE 


DELETE 方 法 要 求 服务 器 根据 CoAP 请 求 中 的 URI 删 除 服 务 器 中 的 指定 资源 。 如 果 资 源 删除 成 功 ， 那 么 服务 器 应 返回 一 个 包含 2.02 (Deleted) 响应 码 的 CoAP 响 应 。 


5.6 ”CoAP 响 应 码 


与 HTTP 类 似 ，CoAP 也 包含 三 种 不 同类 型 的 响应 码 一 一 2.xx Success (Y) 、4.xx Client Error. (客户 端 错误 ) 和 5.xx Server Error. (服务 器 错误 ) 。CoAP 响 应 码 和 HTTP 状 态 码 存在 很 强 的 对 应 关 
系 。 


5.6.1 “正确 响应 


若 服务 器 正确 执行 CoAP 请 求 ， 将 会 返回 一 个 表示 执行 正确 的 响应 码 ， 这 些 响 应 码 包 括 2.01 Created、2.02 Deleted、2.03 Valid、2.04 Changed 和 2.05 Content。 
1.2.01 Created 


类 似 于 HTTP 201 Created， 该 响应 码 只 能 应 用 于 POST 或 PUT 响应 中 ， 表 示 服 务 器 创建 了 一 个 新 的 资源 。2.01 Created 和 2.04 Changed 响 应 码 均 可 应 用 于 POST 或 PUT 响应 中 。 但 2.01 Created 表 示 创 
建 资源 ， 资 源 的 状态 从 无 到 有 ; 而 2.04 Changed 表 示 更 新 资源 ， 资 源 的 状态 从 旧 到 新 。 


2.2.02 Deleted 
类 似 于 HTTP 204 No Content， 该 响应 码 只 能 应 用 于 DELETE 响 应 中 ， 表 示 服 务 器 成 功 删除 一 个 资源 。 
3.2.03 Valid 


类 似 于 HTTP 304 Not Modified, 2.03 Valid 和 2.05 Content 常 用 于 GET 响 应 中 ， 但 两 者 存在 一 些 区 别 ， 包 含 2.03 Valid 响应 码 的 CoAP 响 应 中 负载 内 容 一 般 为 空 ， 而 包含 2.05 Content 响 应 码 的 CoAP 
响应 中 一 般 包含 具体 负载 。 


4.2.04 Changed 


类 似 于 HTTP 204 No Content， 该 响应 码 只 能 应 用 于 POST 和 PUT 响应 中 ， 表 示 服 务 器 更 新 了 某 个 资源 。 


5.2.05 Content 


类 似 于 HTTP 200 OK， 该 响应 码 只 能 应 用 于 GET 响 应 中 ， 这 可 能 是 客户 端 最 愿意 看 到 的 响应 码 。 


5.6.2 ”客户 端 错误 

若 CoAP 服 务 器 发 现 客户 端 请 求 错 误 ， 将 返回 一 个 包含 客户 端 错误 的 响应 码 。 这 些 响 应 码 包括 4.00 Bad Request, 4.01 Unauthorized, 4.02 Bad option, 4.03 Forbidden, 4.04 Not Found, 4.05 
Method Not Allowed、4.06 Not Acceptable 和 4.12 Precondition Failed。 

1.4.00 Bad Request 

类 似 于 HTTP 400 Bad Request, 4.00 Bad Request 表 示 通 用 客户 端 状态 指示 ， 当 使 用 其 他 4.XX 无 法 描述 客户 端 错误 时 可 直接 使 用 4.00 Bad Request, 

2.4.01 Unauthorized 


该 响应 码 表示 客户 端 未 获取 权限 去 执行 相关 操作 。 客 户 端 在 没有 提供 适当 的 身份 例证 的 情况 下 向 服务 器 中 受 保护 的 资源 发 送 请 求 时 ， 若 服务 器 不 想 承 认 该 资源 存在 于 服务 器 ， 可 返回 4.04 Not Found 代 
$854.01 Unauthorized, 


3.4.02 Bad option 

该 响应 码 表示 请 求 中 包含 一 个 或 多 个 未 能 识别 的 选项 。 

4.4.03 Forbidden 

类 型 于 HTTP 403 Forbidden， 该 响应 码 表示 客户 端 请 求 格式 正确 ， 但 是 服务 器 并 不 愿意 执行 该 请 求 。 
5.4.04 Not Found 

类 似 于 HTTP 404 Not Found, 4.04 Not Found 表 示 服 务 器 无 法 寻找 到 地 址 资源 。 

6.4.05 Method Not Allowed 


类 似 于 HTTP 405 Method NOT Allowed, 4.05 Method Not Allowed 表 示 客 户 端 使 用 一 个 未 经 服务 器 定义 的 CoAP 方 法 访问 某 资源 。 例 如 该 资源 仅 支 持 POST 方法 ， 但 是 客户 端 使 用 PUT 方法 修改 资 
此 时 CoAP 服 务 器 将 返回 4.05 Method Not Allowed。 
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7.4.06 Not Acceptable 


类 似 于 HTTP 406 Not Acceptable， 即 客户 端 请 求 中 带 有 Accept 选 项 ， 而 服务 器 无 法 根据 Accept 选 项 返回 指定 内 容 。 例 如 服务 器 内 的 某 资源 仅 支 持 JSON 格 式 或 文本 格式 ， 但 CoAP 客 户 端 却 希望 获得 
XML 格式 负载 ， 由 于 CoAP 服 务 器 无 法 满足 CoAP 客 户 端 的 期 望 ， 只 能 返回 4.06 Not Acceptable。 


8.4.12 Precondition Failed 


类 似 于 HTTP 412 Precondition Failed， 客 户 端 在 请 求 中 定义 了 一 个 或 多 个 先决 条 件 ， 例 如 在 请 求 中 增加 If-Match 选 项 ， 而 服务 器 只 有 在 满足 特定 条 件 下 才 可 以 处 理 该 请 求 ， 若 特定 条 件 无 法 满足 ， 服 
务 器 将 返回 4.12 Precondition Failed。 


5.6.3 ”服务 器 错误 


若 CoAP 服 务 器 由 于 自身 问题 无 法 正确 执行 CoOAP 请 求 ， 那 么 将 会 返回 一 个 服务 器 错误 响应 码 ， 这 些 响应 码 包括 5.00 Internal Server Error, 5.01 Not Implemented 和 5.03 Service Unavailable, 


1.5.00 Internal Server Error 


类 似 于 HTTP 500 Interal Server Error, 5.00 Internal Server Error 是 一 个 通用 的 服务 器 错误 响应 ， 若 使 用 其 他 5.XX 响 应 码 无 法 正确 描述 错误 可 直接 使 用 5.00 Internal Server Error, 


2.5.01 Not Implemented 
类 似 于 HTTP 501 Not Implemented, 5.01 Not Implemented 表 示 CoAP 服 务 器 不 支持 请 求 中 规定 的 某 些 特性 。 


3.5.03 Service Unavailable 


类 似 于 HTTP 503 Service Unavailable, 5.03 Service Unavailable 意 味 着 虽然 CoAP 服 务 器 正常 启用 ， 但 是 某 些 应 用 并 没有 正常 工作 。 例 如 ， 众 多 的 CoAP 客 户 端 向 服务 器 发 送 CoAP 请 求 ，CoAP 服 务 
器 无 法 及 时 处 理 所 有 的 请 求 ， 在 这 种 情况 下 CoAP 服 务 器 可 返回 5.03 Service Unavailable 响 应 码 。 


5.7 ”CoAP 选 项 


CoAP 定 义 了 一 系列 选项 用 以 规范 CoAP 报 文 的 格式 。 一 个 CoAP 报 文中 可 以 包括 多 个 CoAP 选 项 。CoAP 选 项 是 CoAP 中 最 难 理解 的 部 分 。 


CoApP 选 项 实例 由 选项 偏 移 量 (Option Delta) 、 选 项 长 度 (Option Length) 和 选项 值 (Option Value) 组 成 。CoAP 选 项 的 具体 格式 如 图 5-13 所 示 。CoAP 中 不 能 直接 确定 选项 编号 ， 选 项 编号 必须 


由 上 一 个 选项 编号 和 本 次 选项 偏 移 量 计 算得 到 。 


0 4 0 8 
Option Delta 


Option Delta 
(enxtended) 
Option Length 
(enxtended) 


Option Value 


图 5-13 ”选项 格式 
1. 选 项 偏 移 量 
4 位 无 符号 整数 。 其 中 0 ~ 12 用 于 指示 选项 的 偏 移 量 ，13、14 和 15 具 有 特殊 合 义 。 
: 13: Option Delta extended 区 域 定义 一 个 8 位 无 符号 整数 ， 此 时 的 选项 偏 移 量 应 为 该 8 位 无 符号 整数 +13。 
: 14: Option Delta extended 区 域 定义 一 个 16 位 无 符号 整数 ， 此 时 的 选项 偏 移 量 应 为 该 16 位 无 符号 整数 +269。 
15: 保留 为 将 来 使 用 。 


选项 偏 移 量 描述 了 当前 选项 编号 与 之 前 选项 编号 之 间 的 差 值 ， 换 句 话 说 选项 编号 可 以 由 当前 选项 编号 与 之 前 的 选项 编号 计算 得 到 。 例 如 ， 上 次 选项 编号 为 11 (Uri-Path) ， 当 前 选项 偏 移 量 为 4， 那 么 
当前 的 选项 编号 为 15 (Uri-Query) 。 


2. 选 项 长 度 
4 位 无 符号 整数 。0 ~ 12 用 于 指定 选项 长 度 ，13、14 和 15 具 有 特殊 含义 。 
: 13: Option Length extended 区 域 定义 一 个 8 位 无 符号 整数 ， 此 时 的 选项 长 度 应 为 该 8 位 无 符号 整数 +13。 
: 14: Option Length extended 区 域 定义 一 个 16 位 无 符号 整数 ， 此 时 的 选项 长 度 应 为 该 16 位 无 符号 整数 +269。 
15: 保留 为 将 来 使 用 。 
3. 选 项 值 
在 CoAP 中 选项 值 包含 四 种 数据 类 型 一 -Empty、Opaque、Uint 和 String。 
: Empty: 选项 值 长 度 为 0。 
. Opaque: 选项 值 长 度 不 确定 。 
| Uint: 选项 值 长 度 为 非 负 整数 ， 该 值 采用 网 络 字 节 顺序 即 大 端 格式 定义 。 


` String: UTF-8 编 码 字 符 串 格式 。 


COoAP 选 项 定义 见 表 5-3。 


表 5-3 CoAP 选 项 定义 


X 项 值 数据 类 型 长 度 定义 / 字 节 


5.7.2 URI 相关 选项 


在 CoAP 选 项 中 共有 4 个 选项 与 URI 直 接 相关 一 一 Uri-Host、Uri-Port、Uri-Path 和 Uri-Query。 这 些 参 数 都 可 以 用 于 定位 服务 器 资源 ，CoAP 的 资源 定位 规则 也 符合 URL 语 法 ， 例 如: 


coap://wsnccoap.org:5683/devices/1234CDEF?1imit=10&offset=20 


- Uri-Host 用 于 定义 服务 器 名 称 ， 此 CoAP URI 示 例 中 Uri-Host 等 于 “wsnccoap.org” b 
- Uri-Port 用 于 定义 服务 器 CoAP 服 务 端 口号 ， 此 CoAP URIE f) Uri-Port& 4& 29 5683. 


- Uri-Path 用 于 定义 资源 在 服务 器 中 的 相对 或 绝对 位 置 ， 在 此 CoAP URI 示 例 中 Uri-PATH 等 于 “devices/1234CDEF”。 此 时 “devices/1234CDEF” 被 分 成 了 两 个 Uri-Path: 一 个 为 “devices”， 另 一 个 
为 “1234CDEF”。 与 其 他 CoAP 选 项 实例 一 样 ，CoAP 选 项 编号 和 选项 长 度 均 被 完整 定义 ， 所 以 CoAP 选 项 中 并 没有 “/” 这 样 的 分 隔 符 ， 也 就 是 说 “devices” 和 “1234CDEF” 之 间 的 “/” 绝 不 会 出 现在 


CoAP 选项 内 o 


Uri-Query 用 于 定义 资源 的 查询 参数 ， 在 此 CoAP URI 示 例 中 Uti-Quety 等 同 于 “?limit=10&coffset=20”， 与 Ufi-Path 中 的 情况 相似 ， 像 D 和 “& ”这样 的 分 隔 符 并 不 会 出 现在 CoAP 选 项 内 。 此 处 也 有 两 
个 Uri-Query: 一 个 为 “limit=10” ， 另 一 个 为 “offset=20” 。 


5.7.3 Content-Format 选 项 


Content-Format 选 项 用 于 指示 CoAP 选 项 中 的 负载 媒体 类 型 ，CoAP 负 载 媒体 类 型 采用 整数 编号 的 方式 定义 ， 该 编号 采用 无 符号 整数 表示 ， 不 同 的 媒体 类 型 采用 不 同 的 编号 ， 如 二 进 制 负载 的 媒体 类 型 
编号 为 42，JSON 负 载 的 媒体 类 型 编号 为 50。Content-Format 和 HTTP 中 的 Content-Type 非 常 相似 ， 在 HTTP 中 若 表示 负载 为 JJON 格 式 ， 需 要 在 HTTP 首 选项 中 加 入 “Content-Type: 
Application/jsonN^n" ， 在 传输 过 程 中 该 部 分 至 少 需要 占用 31 字 节 ， 而 在 CoAP 中 却 只 占用 3 字 节 。CoAP 媒 体 类 型 的 相关 内 容 请 参考 5.8 节 。 


5.7.4 Accept 选 项 


Accept 选 项 用 于 表示 CoAP 客 户 端 期 望 接 收 到 的 媒体 类 型 格式 ，Accept 选 项 的 负载 类 型 定义 和 Content-Format 选 项 的 负载 类 型 定义 完全 相同 。 如 果 CoAP 请 求 中 没有 包含 Accept 选 项 ， 那 么 CoAP 服 务 
器 将 返回 默认 媒体 类 型 ; 若 CoAP 选 项 中 包含 Accept 选 项 ，CoAP 服 务 器 根据 客户 端 期 望 的 媒体 类 型 返回 响应 负载 ， 如 果 服 务 器 不 能 返回 指定 格式 的 响应 ， 那 么 可 在 CoAP 响 应 中 加 入 4.06 (Not 
Acceptable) 响应 码 。 


通常 情况 下 资源 可 以 采用 不 同 的 媒体 类 型 描述 ， 例 如 一 个 温度 传感器 资源 可 以 使 用 文本 类 型 描述 ， 也 可 以 采用 JSON 格 式 描述 ， 更 可 以 使 用 2 字 节 无 符号 整数 这 样 的 二 进 制 方式 描述 。 若 采用 二 进 制 方式 
描述 响应 负载 ， 需 要 提前 定义 大 小 端 格 式 ， 在 网 络 传输 过 程 中 一 般 采 用 大 端 格式 。 图 5-14 展 示 了 Accept 选 项 和 Content-Format 选 项 如 何 配合 使 用 。 


5.7.5 ”Etag 选 项 
与 HTTP 相 似 ，CoAP 中 也 包含 Etag 选 项 ， 而 且 CoAP 中 的 Etag 选 项 与 HTTP 中 Etag 首 部 字段 的 使 用 方法 非常 相似 。Etag 可 以 理解 为 资源 的 实体 标记 ， 它 用 来 表示 资源 的 新 鲜 程度 ， 当 资源 发 生 改 变 时 
Etag 的 值 也 需要 更 新 。 


无 论 是 在 CoAP 中 还 是 在 HTTP 中 ，Etag 并 没有 统一 的 计算 规则 ， 但 是 无 论 如 何 Etag 的 具体 值 都 是 由 服务 器 分 配 。Etag 可 以 有 很 多 方法 生成 ， 如 版 本 号 、 校 验 和 、 单 向 散 列 值 和 时 间 参 数 等 。 在 实际 应 用 
中 ， 单 向 散 列 值 往往 是 最 受 欢迎 的 计算 Etag 的 方法 。 


CoAP 客 户 端 


Get /temperature 
Accept: text/plain 


Content-Format: text/plain 
"E . S” 


Get /temperature 
Accept: applcation/Json 


Content-Format: applcation/Json 
t value": 22.5j 


Get /temperature 


Accept: applcation/octect-stream 
一 


Content-Format: octect-stream 
0x0016 


图 5-14  Accepti& 7f faContent-Format i$ Jf 


CoAP 服 务 需 


JSON 


类 


型 


Etag 既 可 以 出 现在 CoAP 请 求 中 ， 也 可 出 现在 CoAP 响 应 中 ， 而 且 在 CoAP 中 ，Etag 的 具体 值 还 经 常 与 If-Match 选 项 配合 使 用 。 虽 然 CoAP 中 的 Etag 和 HTTP 中 的 Etag 首 部 字段 的 用 法 相似 ， 但 是 CoAP 中 


Etag 的 具体 值 一 般 为 二 进 制 形式 ， 而 HTTP 的 Etag 首 部 选项 一 般 采 用 字符 串 形 式 。 下 面 通过 一 个 例子 说 明 Etag 在 CoAP 中 的 使 用 方法 ， 具 体 过 程 如 图 5-15 使 用 。 


1) CoAP 客 户 端 通过 GET 方 法 试图 获取 名 为 “validate” 的 资源 内 容 。 


2) CoAP 服 务 器 将 返回 名 为 “validate” 的 资源 体内 容 ，CoAP 响 应 中 除了 包含 “2.05 Content” 响 应 码 之 外 ， 还 包含 Etag 选 项 ， 此 时 Etag 选 项 的 具体 值 为 二 进 制 形式 表示 的 “0x9868” , 


3) CoAP 客 户 端 将 会 缓存 响应 内 容 ， 并 且 将 保留 服务 器 返回 的 Etag。 


4) 经 过 一 段 时 间 之 后 CoAP 客 户 端 再 次 请 求 “validate” 资源 ， 由 于 CoAP 客 户 端 已 经 缓存 该 资源 的 Etag 具 体 值 ， 所 以 在 本 次 请 求 中 CoAP 请 求 首部 中 加 入 了 Etag 选 项 。 


5) COoAP 服 务 器 收 到 请 求 之 后 取出 请 求 首部 中 的 Etag 值 ，CoAP 服 务 器 发 现 请 求 中 的 Etag 值 与 服务 器 中 “validate” 的 Etag 值 完全 相同 ， 说 明 资 源 并 没有 被 更 新 。 此 时 CoAP 服 务 器 返回 的 响应 码 
73 "2.03 Valid”， 但 CoAP 响 应 中 并 没有 响应 内 容 。 


6) CoAP 客 户 端 接收 到 服务 器 的 响应 ， 发 现 响 应 码 为 “2.03 Valid”， 说 明 客户 端 请 求 的 资源 并 没有 改变 ， 直 接 使 用 之 前 的 缓存 即 可 。 


7) 某 时 刻 CoAP 服 务 器 中 的 


"validate" 资源 被 改变 ， 服 务 器 重新 计算 该 资源 的 Etag，Etag 值 被 更 新 为 二 进 制 形式 的 “0x559d” , 


8) 经 过 一 段 时 间 之 后 CoAP 客 户 端 再 次 请 求 该 资源 ， 但 请 求 中 的 Etag 具 体 值 依然 为 原 缓存 值 “0x9868”。 


9) 服务 器 发 现 请 求 中 的 Etag 值 与 此 时 服务 器 中 “validate” 资源 的 最 新 Etag 值 不 相符 ， 于 是 把 最 新 的 资源 和 与 该 资源 对 应 的 Etag 重 新 返回 至 CoAP 客 户 端 ， 那 么 响应 码 变 为 “2.05 Content" , 


载 中 也 包含 最 新 的 资源 具体 内 容 。 


响应 负 


10) CoAP 客 户 端 接收 到 该 响应 之 后 ， 重 新 缓存 Etag 具 体 值 和 资源 具体 内 容 。 更 新 之 后 Etag 具 体 值 “0x559d” 将 在 之 后 的 GET 请 求 中 再 次 使 用 。 


CoAP7Z& FP! ij CoAPHE AS 2& 


EI 

Etag: 0x9868 
2.05 Content 
Etag: 0x9868 | resource | 


Get /validate 
IRRI IIIT Etag 


resource | 


Etag: 0x9868 


Get /validate ! 
Etag: 0x9968 : | 


使 用 缓存 一 > 


resource | 


Etag: 0x9868 


2.03 Valid 无 啊 应 内 容 


' | Get /validate | resource | 
更 新 缓存 并 更 新 Etag ' Etag: 0x9868 | 
! i : Etag: 0x559d 


resource | 


Etag: 0x559d 


| 


2.05 Content 
Etag: 0x559d | 
Y 


图 5-15 ”Etag 使 用 示例 


: Etag 选 项 一 般配 合 GET 方 法 使 用 。 
: Etag 选 项 可 以 节省 响应 内 容 ， 让 CoAP 客 户 端 充分 利用 本 地 缓存 。 
: Etag 选 项 既 可 以 出 现在 CoAP 请 求 中 ， 也 可 以 出 现在 CoAP 响 应 中 。 


Etag 选 项 总 是 由 服务 器 生成 ， 客 户 端 必须 无 条 件 缓存 Etag。 


5.7.6 | 上 -Match 选 项 


如 果 请 求 中 包含 If-Match 选 项 或 上 f-None-Match 选 项 ， 称 这 类 CoAP 请 求 为 CoAP 条 件 请 求 ，If-Match 选 项 一 般 用 于 更 新 服务 器 资源 ， 其 具体 值 一般 采 用 Etag 选 项 的 具体 值 。 


If-Match 选 项 的 使 用 方法 也 非常 简单 ， 如 果 服 务 器 收 到 的 If-Match 选 项 值 与 被 更 新 资源 的 Etag 值 相同 ， 则 认为 该 条 件 请 求 有 效 ， 响 应 码 为 “2.04 change" ; 如 果 服 务 器 收 到 的 If-Match 选 项 值 与 被 更 
新 资源 的 Etag 值 不 相同 ， 则 认为 该 条 件 请 求 无 效 ， 响 应 码 为 “4.12 Precondition Failed”。 


HTTP 中 也 有 相似 的 条 件 请 求 ， 这 些 条 件 请 求 一 般 包 括 If-Match、If-None-Match 和 If-Modify-Since 等 请 求 首部 字段 。CoAP 中 条 件 请 求 的 使 用 方法 与 HTTP 相 似 ， 但 CoAP 中 的 相关 选项 总 是 优先 使 用 
二 进 制 形 式 ， 这 点 与 HTTP 中 各 种 首部 字段 存在 明显 差异 。 


下 面 通过 一 个 具体 的 例子 说 明 If-Match 的 使 用 方法 ， 具 体 过 程 如 图 5-16 所 示 。 

1) CoAP 客 户 端 通过 GET 方 法 试图 获取 名 为 “validate” 的 资源 内 容 。 

2) CoAP 服 务 器 将 返回 名 为 “validate” 的 资源 内 容 ，CoAP 响 应 中 除了 包含 “2.05 Content” 响 应 码 之 外 ， 还 包含 Etag 选 项 ， 此 时 Etag 选 项 的 具体 值 为 二 进 制 形式 表示 的 “0x559d” 。 
3) CoAP 客 户 端 将 会 缓存 响应 内 容 ， 并 且 将 保留 服务 器 返回 的 Etag。 


4) 经 过 一 段 时 间 之 后 CoAP 客 户 端 试 图 修改 “validate” 资源 内 容 ， 此 时 CoAP 客 户 端 通过 PUT 方法 更 新 资源 ， 在 CoAP 请 求 负载 中 加 入 资源 具体 内 容 ， 在 CoAP 选 项 中 加 入 If-Match 选 项 ， 而 If-Match 
选项 的 具体 值 为 本 地 缓存 的 Etag 具 体 值 "0x559d" , 


5) CoAP 服 务 器 收 到 该 PUT 请 求 之 后 发 现 请 求 首部 中 If-Match 选 项 的 具体 值 与 本 地 资源 的 Etag 值 完全 相同 ， 所 以 认为 该 PUT 请 求 合 法 。CoAP 服 务 器 将 使 用 客户 端 请 求 负载 中 的 内 容 更 新 资源 ， 并 重新 
计算 该 资源 的 Etag 值 。CoAP 响 应 中 响应 码 为 “2.04 Changed”，CoAP 响 应 中 还 包括 更 新 之 后 的 Etag 具 体 值 “0x6cfa”。 


6) CoAP 客 户 端 收 到 该 响应 ， 缓 存 了 响应 中 的 Etag 具 体 值 “0x6cfa” 以 备 下 次 使 用 。 
7) 在 某 一 时 刻 其 他 CoAP 客 户 端 修改 了 “validate” 资 源 ， 服 务 器 中 “validate” 资 源 的 Etag 具 体 值 被 重新 计算 为 “0x2f09”。 
8) 经 过 一 段 时 间 之 后 CoAP 客 户 端 试 图 再 次 更 新 “validate” 资源 ， 在 CoAP 请 求 中 使 用 If-Match 选 项 ， 该 选项 的 具体 值 为 之 前 缓存 的 Etag 具 体 值 “0x6cfa” 。 


9) CoAP 服 务 器 接收 到 该 请 求 之 后 发 现 If-Match 选 项 的 具体 值 与 资源 Etag 的 具体 值 并 不 匹配 ， 此 时 CoAP 服 务 器 认为 该 客户 端 并 不 能 更 新 该 资源 ， 所 以 在 响应 中 响应 码 变更 为 “4.12 Precondition 
Failed" , 


10) CoAP 客 户 端 收 到 该 响应 后 知晓 本 次 PUT 请 求 失败 ， 如 果 需 要 正确 更 新 “validate” 资源 ， 需 要 先 发 起 GET 请 求 获取 最 新 资源 内 容 ， 重 新 修改 之 后 再 发 起 PUT 请 求 。 


.IEMatch 选 项 一 般 和 Etag 具 体 值 配合 使 用 。 


. 在 CoAP 请 求 中 ，IEMatch 选 项 往往 配合 PUT 请 求 或 POST 请 求 使 用 ， 而 Etag 选 项 配合 GET 请 求 使 用 。 
g 


GET /validate 


2.05 Content 
Etag: 0x559d 


Etag: 0x559d 


PUT /validate 
If-Match: 0x559d 


货源 和 锌 更 新 
Etag: 6cfa 
资源 被 其 他 
Y 客户 问 更 新 


2.04 Changed | 


Etag: Ox6cfa Etag: Ox6cfa 


PUT /validate 


If-Match: Ox6cfa 
一 


Etag: Ox2f09 


4.12 Precondition Failed 
一 一 一 一 一 一 一 一 | 


Y 


图 5-16 If-Match 45] 


: If-Match 选 项 一 般 用 于 更 新 已 经 存在 的 资源 ， 所 以 往往 需要 通过 GET 请 求 获 取 资 源 的 Etag 具 体 值 。 


it 
©: 此 处 的 请 求 失败 与 CoAP 重 传 中 提 到 的 请 求 失败 的 含义 完全 不 同 ， 在 CoAP 重 传 中 请 求 失败 是 由 于 传输 过 程 导致 的 ， 而 此 处 的 请 求 失败 是 由 于 应 用 处 理 过 程 导 致 的 ， 两 者 的 含义 完全 不 同 。 


5.7.7 | 上 f-None-Match 选 项 
If-None-Match 选 项 和 If-Match 选 项 的 使 用 方法 相似 ，If-None-Match 选 项 一 般 用 于 在 服务 器 上 创建 一 个 新 资源 ， 而 If-Match 选 项 一 般 用 于 修改 已 经 在 服务 器 中 存在 的 资源 。 下 面 依然 通过 一 个 示例 
说 明 如 何 使 用 If-None-Match 选 项 ， 具 体 过 程 如 图 5-17 所 示 。 


1) CoAP 客 户 端 A 试图 在 服务 器 中 创建 “create1” 资 源 ， 在 CoAP 请 求 中 增加 了 If-None-Match 选 项 。CoAP 客 户 端 A 在 服务 器 上 成 功 创建 了 该 资源 ， 服 务 器 返回 CoAP 响 应 的 响应 码 为 “2.01 
Created" , 


2) CoAP 客 户 端 B 也 试图 在 服务 器 中 创建 “create1” 资 源 ， 在 CoAP 请 求 中 也 增加 了 If-None-Match 选 项 ， 但 是 此 时 服务 器 已 经 创建 了 “create1” 资源 ， 所 以 无 法 执行 该 CoAP 请 求 ， 服 务 器 返回 
CoAP 响 应 的 响应 码 为 “4.12 Precondition Failed" , 


CoAP 客 户 端 B CoAP 客 户 端 A CoAP 服 务 需 


POST /createl | resource | 
If-None-Match 


PUT /createl 
If-None-Match 


4.12 Precondition F ailed 


图 5-17 If-None-Match 使 用 示例 


5.7.8 ”选项 示例 


CoAP 选 项 部 分 非常 复杂 ， 为 了 更 好 地 说 明 CoAP 选 项 的 用 法 ， 下 面 列 举 实际 情况 中 经 常 出 现 的 几 种 CoAP 选 项 组 合 方式 。 
1.Uri-Path 


第 一 个 示例 CoAP 选 项 中 包含 两 组 Uri-Path ， 假 设 此 时 CoAP URI 为 


= 


coap: //example.com:5683/devices/1234CDE 


器 


通过 前 文 的 摘 述 获知 ， 在 CoAP 请 求 中 一 般 可 以 省 略 Uri-Host 和 Uri-Port， 所 以 本 例 中 仅 包 括 两 个 Uri-Path: “devices” 和 “1234CDEF”， 图 5-18 展 示 了 这 两 个 Uri-Path 在 CoAP 首 部 中 的 具体 排列 方 
xis 


Option Delta-11 Option Length-7 
Uri-Path(11) 


Option Value= devlces” 


Option Delta-0 Option Length- 8 


Uri-Path(11) 
Option Value-*1234CDEF" 


图 5-18  Uri-Pathzr 4] 


. 第 一 组 CoAP 选 项 实例 的 选项 偏 移 量 为 11， 由 于 该 部 分 是 CoAP 首 部 中 的 第 一 个 选项 ， 那么 此 时 的 选项 偏 移 量 就 是 选项 编号 ， 此 时 的 选项 编号 为 Uri-Path (11) 。 选项 长 度 为 7， 选项 值 为 字符 囊 形 式 


€€ $ » 
的 "devices o 


- 第 二 组 CoAP 选 项 实例 的 选项 偏 移 量 为 0， 此 时 的 选项 编号 应 是 上 一 个 选项 编号 加 上 本 次 的 选项 偏 移 量 ， 此 时 的 选项 编号 为 11+0=Uri-Path (11) 。 选 项 长 度 为 8， 选 项 值 为 字符 串 形式 
的 “1234CDEF”。 


2.Uri-Path, Uri-QueryfHAccept 


下 面 构造 一 个 更 为 复杂 的 示例 ， 该 示例 不 但 包括 两 组 Uri-Path， 还 包括 一 组 Uri-Query 和 一 组 Accept。 假 设 此 时 的 CoAP URI 为 


coap://example.com:5683/devices/1234CDEF?1imit=10 


CoAP 客 户 端的 期 望 负 载 为 JSON 格 式 。 图 5-19 很 好 地 展现 了 这 种 复杂 组 合 的 实现 细节 。 
- 两 组 Uri-Path 的 排列 方法 与 上 一 个 示例 完全 相同 。 


- Uri-Query 选 项 一 定 排列 在 所 有 Uri-Path 之 后 ， 该 CoAP 选 项 实例 的 选项 偏 移 量 为 4， 此 时 的 选项 编号 为 之 前 所 有 选项 偏 移 量 之 和 11+0+4=Uri-Query (15) 。 选 项 长 度 为 8， 选 项 值 为 字符 串 形式 
的 “limit=10”。 


Accept 选 项 一 定 排列 在 Uri-Path 之 后 ， 该 选项 的 选项 偏 移 量 为 1， 该 CoAP 的 选项 编号 为 之 前 所 有 选项 偏 移 量 之 和 11+0+4+1=Accept (16) 。 选 项 长 度 为 2， 选 项 值 为 2 字 节 无 符号 整数 50。 


Option Delta=1 1 Option Length=7 
Uri-Path(11) 


Option Value =“devices” 


Option Delta-0 Option Length=8 

1140711 
Uri-Path(11) 
Option Value-*1234CDEF" 


Option Delta-4 Option Length-8 


1 1+0+4=15 


Uri Quqery(15) 
Option Value=“limit=10” 


Option Delta=1 Option Length=2 
114707471716 


Accept( 16) 
Option Value-50 


图 5-19  Uri-Path. Uri-QueryZeAcceptzm 4] 


3. 选 项 长 度 扩 展 


有 时 CoAP URI 较 长 ， 单 个 Uri-Path 的 长 度 可 能 超过 12 字 节 ， 在 下 面 的 URI 中 ， 第 二 个 Uri-Path "11223344AABBCCDD" 长 度 为 16 字 节 ， 此 时 便 需 要 使 用 选项 长 度 扩展 部 分 : 


coap: //example.com:5683/devices/11223344AABBCCDD 


.第 一 个 CoAP 选 项 实例 与 之 前 的 示例 完全 相同 。 
. 第 二 个 CoAP 选 项 实例 的 选项 偏 移 量 为 0， 选 项 长 度 指示 为 13。 当 选项 长 度 为 13 时 ， 选 项 值 之 前 将 增加 选项 长 度 扩展 区 域 以 表示 超过 长 度 13 的 部 分 ， 该 扩展 区 域 的 值 为 3， 那 么 此 时 的 选项 真实 长 度 为 
13+3=16 字 节 。 选 项 长 度 指示 被 分 成 了 两 部 分 : 一 部 分 为 国定 值 13， 另 一 部 分 为 扩展 值 3， 选 项 的 真实 长 度 需 将 两 部 分 相 加 。 虽 然 选 项 长 度 被 分 成 了 两 部 分 ， 但 选项 值 依然 为 字符 串 形式 


的 “11223344AABBCCDD”。 如 图 5-20 所 示 。 


Option Delta-1 1 Option Length-7 


Uri-Path(11) 


Option Value = devices" 
Option Delta-0 Option Length-13 
Option Length(extended)-3 Uri-Path(11) 


Option Value —*11223344AABBCCDD" 


图 5-20 ”选项 长 度 扩展 


5.8 ”CoAP 媒 体 类 型 


CoAP 支 持 多 种 媒体 类 型 ,但 CoAP 支 持 的 媒体 类 型 数量 远 小 于 HTTP 支 持 的 媒体 类 型 ， 可 以 说 CoAP 的 媒体 类 型 是 HTTP 的 媒体 类 型 的 微小 子 集 ， 不 过 在 物 联网 领域 这 些 媒体 类 型 已 经 完全 足够 。CoAP 媒 
体 类 型 采用 编号 的 方式 定义 ， 该 编号 一 般 采 用 2 字 节 无 符号 整数 定义 。CoAP 媒 体 类 型 的 定义 如 表 5-4 所 示 。 


表 5-4 CoAP 媒 体 类 型 


媒体 类 型 i B 
text/plain 0 
application/link-format 40 
application/xml 4] 
application/octet-stream 42 
application/exi 47 

(5) 

媒体 类 型 mO O 5 
application/json 50 
application/cbor 60 


在 物 联网 实际 应 用 中 ， 文 本 类 型 text/plain、 二 进 制 类 型 application/octet-stream、JSON 类 型 application/json 应 用 最 为 广泛 ， 二 进 制 JSON 类 型 application/cbor 也 逐渐 投入 使 用 。 
application/link-format 是 一 种 专属 于 CoAP 的 媒体 类 型 ， 该 媒体 类 型 一 般 在 CoAP 资 源 发 现 中 使 用 。 


5.8.1 link-format 类 型 


link-format 是 CoAP 中 引入 的 新 类 型 ， 该 类 型 配合 CoAP 资 源 发 现 使 用 。CoAP 服 务 器 中 一 般 包 括 一 个 事先 约定 的 路 由 (/.well-known/core) 。CoAP 服 务 器 内 一 般 包 括 较 多 资源 ， 这 些 资源 由 不 同 的 
URI 定 义 。 若 CoAP 客 户 端 通过 GET 方 法 访问 .well-known/core 路 由 ，CoAP 服 务 器 将 相关 资源 的 URI 通 过 link-format 格 式 返 回 至 CoAP 客 户 端 ， 例 如 : 


«sensors/temp»;sz-64;title-Temperature Sensor;ct-50, 
«actuators/relay»;sz-32;title-Lamp Relay;ct-50 


关于 link-format 类 型 的 更 多 内 容 请 参考 6.2 节 。 


5.8.2 文本 与 二 进 制 类 型 


文本 类 型 和 二 进 制 类 型 是 较为 简单 的 媒体 类 型 。CoAP 中 的 默认 媒体 类 型 为 文本 类 型 


。 若 负载 为 文本 类 型 ， 无 论 在 CoAP 请 求 或 CoAP 响 应 中 均 不 需要 指定 Content-Format。 虽 然 文本 类 型 使 用 非常 简 
单 ， 但 是 也 存在 一 定 的 局 限 性 。 例 如 使 用 文本 类 型 表示 三 个 传感器 检测 结果 ， 


可 能 采用 这 样 的 方式 定义 负载 内 容 : 


12.3,80.5,1890 


传输 双方 需要 提前 定义 三 种 传感器 检测 结果 的 排列 顺序 ， 如 温度 传感器 结果 在 前 ， 湿 度 传感器 在 后 


， 光 照 传感器 位 于 最 后 。 在 上 面 的 示例 中 ， 温 度 检 测 结果 为 12.3， 湿 度 检测 结果 为 80.5， 光 照 检 测 结 
果 为 1890。 虽 然 文 本 类 型 比较 实用 ， 但 没有 JSON 或 CBOR 类 型 灵活 。 


在 某 些 物 联 网 应 用 中 ，TLV 形 式 的 二 进 制 负载 也 广 受 欢迎 ，TLV 中 的 T 表 示 类 型 ，L 代 表 长 度 ， 而 V 表 示 具 体内 容 ， 表 面 来 看 TLV 形 式 的 二 进 制 类 型 非常 节约 空间 ， 但 是 也 带 来 一 定 的 浪费 或 麻烦 。 
: 工 的 定义 可 能 与 CoAP 中 的 方法 重复 ， 例 如 IT=0x01 表 示 数 据 上 传 ，T=0x02 表 示 数 据 更 新 ， 那 么 此 时 工 的 定义 便 和 CoAP 中 的 POST 方法 和 DELETE 方 法 重复 。 


.V 的 设计 也 存在 很 多 “误区 ”， 如 整数 传输 的 大 小 端 问题 、 浮 点 数 长 度 问 题 和 大 小 端 问题 、 负 数 保 存 的 问题 等 。 


5.8.3 JSON 类 型 


JSON (JavaScript Object Notation) [是 一 种 轻 量 级 的 数据 交换 格式 。JSON 格 式 易于 人 类 阅读 和 编写 ， 同 时 也 易于 机 器 解析 和 生成 。JSON 采 用 完全 独立 于 计算 机 语言 的 文本 格式 ， 但 也 使 用 了 类 似 
于 C 语 言 家 族 的 习惯 。 这 些 特性 使 JSON 成 为 理想 的 数据 交换 手段 。JSON 有 两 种 构成 结构 一 一 JSON 对 象 和 JSON 数 组 。 


1.JSON 对 象 


JSON 对 象 是 一 个 无 序 的 键 值 对 集合 。 一 个 JSON 对 象 以 “{” 开 始 并 以 “}” 结 束 。 每 个 “ 键 ”后 跟 一 个 “: ” (分 号 ) ， 每 组 键 值 对 之 间 使 用 “，” (逗号 ) 分 隔 。 如 图 5-21 所 示 为 JSON 对 象 的 基本 构 
造 方法 。 


图 5-21 JSON 对 象 (图 片 来 自 json.org) 


2.JSON 数 组 


JSON 数 组 是 值 的 有 序 集合 。 一 个 数组 以 “[” 开 始 并 以 “]” 结 束 。 值 之 间 使 用 “,，” 


(逗号 ) 分 隔 。 如 图 5-22 所 示 为 JJON 数 组 的 基本 构造 方法 。 


array 


图 5-22 JSON 数 组 (图片 来 自 json.org) 


ł 


fEJSONZI£HrP, value AN5 SERER (string). XUB (number) 、true、false、null。 除 此 之 外 ， 值 也 可 以 是 另 一 个 JSJON 对 象 或 数组 。 换 句 话 说 ，JSON 对 象 和 JSON 数 组 可 以 任 
ERE, 
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3.JSON 格 式 示例 


下 面 通过 一 个 示例 说 明 JSON 对 象 和 JSON 数 组 的 具体 使 用 方法 。 该 示例 存在 JSON 数 组 和 JSON 对 象 嵌 套 情况 ， 需 要 逐 层 由 外 向 内 分 析 ， 最 外 层 的 JSON 对 象 包 括 两 个 键 值 对 ， 第 一 个 键 值 对 的 键 名 
为 “total” 而 键 值 为 整数 3， 在 JSJON 格 式 中 字符 串 必 须 使 用 引号 ("") 包 襄 ， 而 数值 、true、false 和 null 不 需要 引号 包 庄 ; 另 一 个 键 值 对 的 键 名 为 “rows”， 而 键 值 为 一 个 JSON 数 组 。 在 嵌 套 的 JSON 数 组 
中 包含 三 个 类 似 的 JSON 对 象 。 最 内 层 的 JSON 对 象 包含 两 组 键 值 对 : 第 一 组 键 值 对 的 键 名 为 “temp”， 键 值 为 24.5; 第 二 组 键 值 对 的 键 名 为 “hum” ， 键 值 为 89。 


"total": 3, 
"rows": [ 
í 
temp": 24.5, 
"hum": 89 
), 
{ 
temp": 25.5, 
"hum": 90 


在 互联 网 或 物 联网 领域 ，JSON 格 式 非常 实用 ， 所 以 有 必要 熟练 掌握 它 。 


[1] http:/ /json.org/json-zh.html. 


59 “本章 小 结 


过 本 章 的 学 习 可 以 发 现 ，CoAP 借 鉴 了 HTTP 的 设计 思想 但 并 没有 盲目 抄袭 或 压缩 HITTP。CoAP 具 有 以 下 特点 : 


m 


.CoAP 首 部 非常 短 ， 且 采用 二 进 制 形式 表示 。 

- CoAP 报 文 分 为 CON 报 文 、NON 报 文 、ACK 报 文 和 RST 报 文 。 
: COAP 请 求 / 响 应 可 采用 携带 模式 或 分 离 模式 。 

: CoAP 同 样 使 用 URI 定 位 资源 。 

.CoAP 具 有 和 HTTP 语 义 相似 的 请 求 方法 和 响应 码 。 

.CoAP 支 持 多 种 媒体 类 型 。 


在 第 7 章 ， 我 们 将 使 用 C 语 言 、Python、Java 和 Node.js 语 言 实现 CoAP 客 户 端 和 服务 器 ， 通 过 后 面 章 节 的 学 习 ， 我 们 会 发 现 CoAP 不 但 设计 简洁 ， 而 且 使 用 也 非常 方便 。 


43568 CoAP 扩 展 


6.1 本章 主要 内 容 


本 章 继续 学 习 CoAP 的 其 他 部 分 ， 这 些 部 分 包括 CoAP 资 源 描 述 、CoAP 观 察 者 模式 。CoAP 资 源 描述 由 《RFC6690 Constrained RESTful Environments (CoRE) Link Formatl1]》 定 义 ， 而 CoAP 观 察 


者 模式 由 《RFC7641 Observing Resources in the Constrained Application Protocol?!) X. 


[1] https:/ /datatracket.ietf.org/doc/rfc6690/ , 


[2] https:/ /datatracker.ietf.org/doc/tfc7641 / 。 


第 6 章 CoAP 扩 展 


6.1 本章 主要 内 容 


本 章 继续 学 习 CoAP 的 其 他 部 分 ， 这 些 部 分 包括 CoAP 资 源 描述 、CoAP 观 察 者 模式 。CoAP 资 源 描述 由 《RFC6690 Constrained RESTful Environments (CoRE) Link Formatl1]》 定 义 ， 而 CoAP 观 察 


者 模式 由 《RFC7641 Observing Resources in the Constrained Application Protocoll?l) sev, 


[1] https:/ /datatracketr.ietf.org/doc/rfc6690/ 。 


[2] https:/ /datatracker.ietf.org/doc/tfc7641 / 。 


6.2 CoAPSUBiu 


CoAP 专 门 为 设备 间 通 信和 而 设计 ， 在 设备 通信 过 程 中 需要 尽 可 能 减少 人 为 干预 。 为 了 实现 设备 在 没有 人 干预 的 情况 下 正常 工作 ，CoAP 引 入 了 资源 发 现 机 制 。 这 种 机 制 可 以 帮助 CoAP 客 户 端 理解 CoAP 服 
务 器 有 哪些 URI 已 经 被 支持 ， 并 且 CoAP 客 户 端 可 以 理解 这 些 URI 的 具体 含义 。CoAP 建 议 CoAP 服 务 器 总 是 支持 一 个 /,well-knownycore 路 由 ， 该 URI 可 以 被 任意 CoAP 客 户 端 访问 。 


6.2.1 “CoOAP 和 资源 摘 述 原理 


当 CoAP 客 户 端 请 求 预先 协商 好 的 /.,well-knownycore 路 由 时 ，CoAP 服 务 器 将 返回 一 系列 的 URI 集 合 。 这 些 URI 集 合 遵循 CORE 链接 标准 。 CoRE 链 接 标准 参考 《RFC6690 Constraint RESTful 
Environment (CoRE) Link Format》。 参 考 CoRE 标 准 返回 的 列表 类 型 被 描述 为 application/link-format， 这 是 CoAP 引 入 的 一 种 全 新 的 媒体 类 型 。CoRE 链 接 标准 定义 了 非常 多 的 选项 ， 但 是 其 中 的 很 多 
部 分 在 实际 使 用 中 并 不 常见 。 下 面 我 们 通过 一 个 简单 的 例子 来 说 明 CoAP 资 源 发 现 和 application/ylink-format 媒 体 类 型 ， 这 个 示例 的 工作 流程 如 图 6-1 所 示 。 


CoA PA Fi CoAP 服 务 器 


Get /.well-known/core 


Content-Format: application/link-format 
«sensors/temp»;sz-64;title—" Temperature Sensor" ;ct-50, 
«actuators/relay?;sz-36;title- Lamp Relay" ;ct-50 


图 6-1 CoAP 资 源 发 现 过 程 


CoAP 客 户 端 访问 /.well-known/core 路 由 之 后 获得 的 响应 内 容 如 下 : 


<sensors/temp>; sz=64;title="Temperature Sensor";ct=50, 
<actuators/relay>; sz=32;title="Lamp Relay";ct-50 


CoAP 服 务 器 告诉 CoAP 客 户 端 自身 有 两 个 资源 (“sensors/temp” 和 “actuators/relay”) 可 以 使 用 ， 通 过 以 上 例子 可 以 获得 以 下 有 用 的 信息 : 
1) 访问 /.well-known/core 路 由 只 能 通过 GET 方 法 ， 也 就 是 说 /.well-known/core 路 由 不 支持 POST、PUT 和 DELETE 方 法 。 


2) CoAP 服 务 器 有 两 个 可 以 被 其 他 设备 访问 的 资源 一 一 “sensor/temp” 和 “actuators/relay”， 资 源 之 间 采 用 “，” (逗号 ) 分 隔 ， 每 个 资源 都 有 各 自 不 同 的 属性 ， 这 些 属 性 通过 “; ” (分 号 ) 分 


3) CoAP 服 务 中 存在 一 个 传感器 设备 ， 该 设备 的 URI 为 sensors 人 /temp， 在 link-format 格 式 中 URI 被 “< >” 包 应 ; 该 资源 还 包括 一 个 title 属 性 ， 通 过 title 属 性 可 获知 该 设备 的 具体 用 途 ， 此 时 该 资源 代表 
一 个 温度 传感器 ; sz 属性 代表 该 资源 的 分 块 大 小 ， 该 属性 在 CoAP 块 传输 中 格外 有 用 ， 此 时 的 块 大 小 为 64， 也 就 是 说 当 使 用 GET 方 法 访问 该 资源 时 ， 最 大 数据 包 的 长 度 为 64 字 节 ; 最 后 该 资源 还 具有 一 个 ct 属 
性 ， 此 时 ct 属性 的 值 为 50， 该 属性 表示 响应 负载 的 媒体 类 型 。 在 CoAP 媒 体 类 型 一 节 可 以 获知 ，“50” 代 表 application/json。 


4) CoAP 服 务 器 中 还 存在 一 个 可 执行 设备 ， 该 设备 的 URI 为 actuators/relay; 与 传感器 资源 相似 ， 该 资源 也 包括 一 个 title 属 性 ， 通 过 title 属 性 可 以 获知 该 设备 是 一 个 控制 台灯 电源 的 继电器 设备 ; 若 使 用 


GET 方 法 或 POST 方法 访问 该 资源 时 ， 最 大 数据 包 的 长 度 为 32 字 节 ; 与 传感器 资源 相同 ， 返 回 至 CoAP 客 户 端的 负载 媒体 类 型 同样 为 application/json 格 式 。 
DE link -format 格 式 和 JSON 格 式 都 使 用 了 “，” GR) de "5 ” (分 号 ) 作为 分 隔 符 ，JSON 对 象 之 间 采 用 “; ”作为 分 隔 符 ，JSON 数 组 中 元 素 之 前 采用 “，” 作 为 分 隔 符 。 而 link-format 中 ， 资 源 
之 间 采 用 “， ”作为 分 隔 符 ， 资 源 的 属性 描述 之 间 采 用 “; ”作为 描述 符 。 请 读者 注意 其 中 的 区 别 与 联系 。 


6.2.2 ”COoAP 和 资源 拉 述评 解 


通过 上 面 的 例子 已 经 对 CoAP 资 源 描述 有 一 个 大 体 的 印象 ,下面 册 对 资源 “URI”、 资 源 类 型 “rt”、 接 口 说 明 “if? 、 负 载 类 型 “ct”、 负 载 长 度 “sz” 和 可 被 观察 “obs” 做 详细 说 明 。 
1. 资 源 URI 

每 一 个 资源 必须 包括 URI， 该 URI 使 用 “< >” 包 庄 ， 例 如 上 文 示 例 中 的 <sensors/temp> 和 <actuators/relay>。 

2. 资 源 类 型 rt 


资源 类 型 rt 是 “Resource Type” 的 简写 ,采用 “ 键 名 称 = 键 值 ” 这 样 的 方式 描述 。 资 源 类 型 rt 可 以 理解 为 一 个 与 应 用 直接 相关 的 描述 字符 串 ， 它 是 用 于 描述 该 资源 的 特定 名 词 。 例 如 
rt="block", rt="Type1 Type2"。 资 源 类 型 和 资源 title 并 不 能 完全 等 同 ，title 更 方便 于 人 类 阅读 理解 ， 而 资源 类 型 rt 更 像 一 个 标记 。 


3. 负 载 类 型 ct 


负载 类 型 ct 是 “Content Format” 的 简写 ， 采 用 “ 键 名 称 = 键 值 ” 这 样 的 方式 描述 。 该 属性 用 于 指示 CoAP 响 应 负载 中 的 媒体 格式 。 此 处 的 键 值 采用 十 进 制 ASCII 码 表示 ， 该 值 的 范围 必须 在 0 ~ 65535 
之 间 ， 也 就 是 说 此 处 的 键 值 为 一 个 无 符号 16 位 整数 。 例 如 ，ct=40 表 示 负 载 媒体 类 型 为 applicatiorVlink-format 类 型 ，ct=50 表 示 负 载 媒体 类 型 为 application/json 类 型 。 


4. 负 载 长 度 sz 


负载 长 度 sz 是 “Maxium Size Estimae” 的 简写 ， 也 采用 “ 键 名 称 = 键 值 ”这 样 的 方式 描述 。 当 使 用 GET 方 式 或 其 他 方式 操作 资源 时 ， 负 载 长 度 sz 用 于 指示 最 大 数据 包 长 度 。CoAP 协 议 支 持 块 传输 ， 该 
参数 对 于 需要 块 传输 的 应 用 来 说 非常 有用。 例如 sz=128 表 示 数 据 包 的 最 大 长 度 为 128。 在 一 些 由 IEEE 802.15.4 组 成 的 网 络 中 ， 单 个 数据 包 的 最 大 长 度 为 127 字 节 ， 即 使 通过 6LoWPAN 这 样 的 头 压缩 技 
术 ，CoAP 层 可 使 用 的 有 效 负载 长 度 也 仅 为 80 字 节 左 右 ， 在 这 些 物 联 网 应 用 中 sz 可 以 等 于 36 或 64。 


5. 可 被 观察 obs 


可 被 观察 obs 是 “observable” 的 简写 。CoAP 支 持 观 察 者 模式 ， 该 模式 与 互联 网 应 用 中 的 订阅 /发 布 模式 较为 相似 。 若 希望 上 文 示例 中 的 温度 传感器 资源 也 支持 观察 模式 ， 可 在 该 资源 描述 中 加 入 obs 属 
性 ，obs 属 性 只 有 键 名 称 而 没有 键 值 。 例 如 : 


<sensors/temp>; sz=64;title="Temperature Sensor";ct=50,obs 


6.3 ”CoAP 观 察 者 模式 


在 物 联 网 应 用 监控 温度 或 湿度 传感器 是 一 个 非常 常见 的 需求 ， 为 了 更 好 地 满足 这 类 需求 CoAP 引 入 了 观察 者 模式 。CoAP 客 户 端 可 以 帮 送 一 个 特殊 观察 请 求 到 CoAP 服 务 器 。 从 该 时 间 点 开始 计算 ， 服 务 
器 将 保存 客户 端的 连接 信息 ， 一 旦 温度 发 生变 化 ， 服 务 器 将 会 把 新 结果 反馈 至 客户 端 。 如 果 CoAP 客 户 端 不 再 希望 获得 温度 检测 结果 ， 那 么 CoAP 客 户 端 将 会 发 送 一 个 注销 请 求 或 RsT 复 位 请 求 ， 此 时 CoAP 服 
务 器 便 会 清除 与 客户 端的 连接 信息 。 


6.3.4 ”观察 者 模式 原理 


在 互联 网 应 用 中 浏览 器 为 了 实时 获取 某 个 资源 ， 可 通过 周期 性 发 送 Ajax 请 求 的 方式 ， 这 样 的 方式 称 为 Ajax 轮 询 。 在 物 联 网 应 用 中 ， 监 控 温度 或 湿度 传感器 的 变化 情况 也 可 以 采用 轮 询 的 方式 ， 轮 询 过 程 
如 图 6-2 所 示 。 
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图 6-2 ”CoAP 轮 询 传 感 器 检测 结果 
如 图 6-2 所 示 的 监控 过 程 是 非常 低 效 的 ， 这 种 低 效 主要 体现 在 两 个 方面 。 第 一 ，CoAP 客 户 端 为 了 获取 服务 器 的 传感器 资源 ， 每 次 都 需要 发 送 一 次 GET 请 求 ， 而 每 次 GET 请 求 的 内 容 完 全 相同 ， 这 显然 是 
一 种 浪费 ;第 二 ，CoAP 客 户 端 按照 一 定 的 时 间 间 隔 请 求 内 容 ， 而 该 时 间 间 隔 可 能 与 服务 器 的 传感器 检测 更 新 时 间 间 隔 并 不 匹配 ， 这 将 会 造成 多 次 请 求 但 是 获得 同一 个 结果 的 糟糕 情况 。 为 了 避免 这 种 情 
况 ，CoAP 中 引入 了 观察 者 模式 ， 观 察 者 模式 的 工作 过 程 如 图 6-3 所 示 。 
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图 6-3 ”CoAP 观 察 者 模式 原理 
CoAP 观 察 者 模式 引入 了 4 个 基本 概念 一 一 Observer、Subject、Registration 和 和 Notification。 
: Observer: CoAP 观 察 者 是 监控 某 种 资源 变化 的 CoAP 客 户 端 
: Subject: CoAP 主 题 是 CoAP 服 务 器 中 某 个 具体 资源 ， 该 资源 将 会 随 着 时 间 的 变化 频繁 更 新 。CoAP 主 题 正 是 CoAP 观 察 者 感 兴趣 的 部 分 。 


: Registration: CoAP 注 册 是 一 个 特殊 的 CoAP GET 请 求 ， 该 GET 请 求 告 知 服务 器 此 时 CoAP 客 户 端 试 图 获取 哪个 资源 的 实时 状态 。 服 务 器 收 到 这 个 特殊 的 GET 请 求 之 后 ， 将 把 CoAP 客 户 端的 信息 保存 到 资 


源 观察 者 列表 中 。 
: Notification: CoAP 指 示 ， 一 旦 服务 的 资源 发 生变 化 ，CoAP 服 务 器 将 会 根据 观察 者 列表 中 记录 的 信息 ， 向 CoAP 客 户 端 反馈 资源 的 当前 状态 。 


在 CoAP 观 察 者 模式 中 ，CoAP 客 户 端 作为 观察 者 ， 而 CoAP 服 务 器 作为 被 观察 者 ， 观 察 过 程 总 是 从 一 个 特殊 的 观察 GET 请 求 开始 。 


6.3.2 ”CoAP 观 察 选项 


为 了 实现 观察 与 通知 功能 ，CoAP 在 选项 中 增加 了 Observe 选 项 ，Observer 选 项 见 表 6-1。 


表 6-1 Observe 选 项 说 明 


当 GET 请 求 中 出 现 Observe 参 数 时 ，CoAP 服 务 器 并 不 会 向 CoAP 客 户 端 反馈 请 求 URI 中 指定 的 资源 ， 而 是 把 CoOAP 客 户 端 和 被 订阅 的 资源 信息 保存 到 观察 者 列表 中 。 在 GET 请 求 中 ，Observe 有 两 个 可 能 
的 取 人 


: Observe=0， 表 示 注 册 操 作 ， 如 果 CoAP 客 户 端 信息 并 不 在 观察 者 列表 中 ， 那 么 服务 器 收 到 该 请 求 之 后 会 把 客户 端 信息 插入 到 观察 者 列表 中 。 
: Obsetve=1， 表 示 注 销 操 作 ，CoAP 服 务 器 将 会 把 观察 者 列表 中 的 客户 端 信息 删除 ， 这 也 就 意味 着 该 订阅 过 程 的 结束 。 


Observe 选 项 也 出 现在 指示 响应 中 ， 在 指示 响应 中 Observe 选 项 类 似 于 序号 ， 该 序号 将 会 不 断 增 加 。 


6.3.3 ”观察 者 模式 示例 

下 面 通 过 两 个 例子 说 明 CoAP 观 察 者 模式 的 详细 工作 流程 ， 通 过 示例 加 深 对 观察 者 模式 的 理解 。 第 一 个 示例 重点 说 明 如 何 注册 动作 和 注销 动作 ， 而 第 二 个 示例 重点 说 明 Max-Age 选 项 如 何 与 观察 者 模式 
配合 使 用 . 

1.CoAP 观 察 者 模式 示例 1 


如 图 6-4 所 示 是 一 个 非常 完整 的 CoAP 观 察 者 模式 工作 流程 ，CoAP 客 户 端 订阅 CoAP 服 务 器 中 的 温度 传感器 资源 ， 一 段 时 间 之 后 CoAP 客 户 端 取 消 了 订阅 ， 整 个 资源 观察 过 程 也 就 此 结束 。 在 该 示例 中 
CoAP 客 户 端 和 服务 器 都 正常 工作 未 出 现 数据 包 丢 失 等 异常 情况 。 
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图 6-4 CoAP 资 源 发 现 示 例 1 
1) CoAP 客 户 端 向 CoAP 服 务 器 订阅 温度 传感器 资源 。CoAP 客 户 端 发 送 带 有 Observe 选 项 的 GET 请 求 ， 此 时 Observe=0， 表 示 订 阅 注册 动作 。 
2) CoAP 发 送 订 阅 请 求 时 ， 还 可 以 在 请 求 中 加 入 Token， 此 时 的 Token 长 度 为 1 字 节 ， 值 为 0x4a。 通 过 第 5 章 可 以 获知 Token 与 应 用 直接 相关 ， 那 么 在 CoAP 观 察 过 程 中 Token 值 应 保持 不 变 。 


3) CoAP 服 务 器 同意 CoAP 客 户 端的 资源 注册 请 求 ， 向 客户 端 返回 温度 传感器 检测 结果 。 响 应 首部 中 包含 “2.05 Content” 响 应 码 。 除 此 之 外 响应 首部 中 还 包括 Observe 选 项 ，Observe 选 项 好 比 订阅 
过 程 的 “计数 器 ”， 在 每 个 CoAP 响 应 中 其 值 逐 渐 累 加 。 


4) Max-Age 选 项 也 经 常 出 现在 CoAP 观 察 者 模式 中 。 在 CoAP 中 资源 也 有 “新鲜” 的 概念 ，Max-Age 好 比 资源 的 保质 期 ， 这 个 保质 期 使 用 秒 为 单位 。 此 处 Max-Age=15， 表 示 温 度 传感器 检测 结果 15 
秒 之 后 便 会 过 期 。Max-Age 的 具体 值 可 以 与 传感器 检测 结果 的 更 新 周期 一 致 。 


5) CoAP 客 户 端 可 向 CoAP 服 务 器 发 送 订 阅 注销 请 求 ， 此 时 Observe= 1 表示 CoAP 客 户 端 不 再 关心 温度 传感器 资源 。 

2.CoAP 观 察 者 模式 示例 2 

在 上 一 个 示例 中 传输 过 程 并 没有 数据 包 丢 失 这 样 的 异常 情况 ， 一 旦 出 现 数据 包 丢 失 ，CoAP 观 察 者 模式 也 可 以 借助 Max-Age 选 项 从 这 种 错误 中 尽快 恢复 ， 如 图 6-5 所 示 。 
1) CoAP 资 源 注册 过 程 与 示例 1 相同 。 


2) CoAP 服 务 器 响应 中 包含 Max-Age=15， 表 示 温 度 传感器 资源 的 “保质 期 ”只 有 15 秒 。CoAP 客 户 端 收 到 温度 传感器 资源 之 后 便 开 始 计 时 ， 一 般 情况 下 在 0 到 Max-Age 之 间 便 可 收 到 下 一 次 传感器 指 
示 。 但 是 由 于 某 种 原因 CoAP 服 务 器 返回 的 CoAP 响 应 在 传输 过 程 中 丢失 。 


3) Max-Age 超 时 时 间 已 经 到 达 ， 传 感 器 数据 结果 已 经 不 再 “新 鲜 ”。CoAP 客 户 端 认为 数据 传输 过 程 发 生 异常 ， 为 了 从 这 种 异常 状态 下 恢复 ，CoAP 客 户 端 重新 发 送 了 资源 注册 请 求 。Max-Age 选 项 使 
CoAP 客 户 端 从 错误 状态 中 及 时 恢复 。 
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图 6-5 ”CoAP 资 源 发 现 示例 2 


64 ”本 章 小 结 


本 章 分 析 了 CoAP 的 两 个 扩展 机 制 一 CoAP 资 源 描述 和 CoAP 观 察 者 模式 。CoAP 主 要 为 设备 间 通 信服 务 ，CoAP 资 源 描述 部 分 可 帮助 CoAP 客 户 端 了 解 CoOAP 服 务 器 中 包含 哪些 资源 ，CoAP 客 户 端 应 该 如 何 
理解 和 利用 这 些 资源 。CoAP 是 一 种 典型 的 物 联网 协议 ， 它 必须 要 符合 物 联 网 应 用 中 的 常见 需求 。 在 物 联网 应 用 中 获取 传感器 的 检测 结果 是 一 个 最 为 常见 的 需求 ， 为 CoAP 中 增加 了 观察 者 模式 后 ， 终 端 可 通 
过 订阅 的 方式 获取 某 个 传感器 的 检测 结果 ， 而 不 需要 使 用 周期 性 轮 询 这 样 的 低 效 方案 。 通 过 资源 描述 和 观察 者 模式 ， 我 们 可 以 发 现 CoAP 为 物 联 网 而 生 ， 为 了 更 好 地 符合 物 联 网 应 用 CoAP 将 会 增加 更 多 更 实 
用 的 扩展 部 分 。 


第 7 章 CoAP 软 件 实现 


7.1 本 章 主要 内 容 


本 章 将 介绍 多 种 CoAP 的 软件 实现 框架 。 随 着 CoAP 标 准 的 完善 和 开源 社区 的 不 断 努 力 ， 市 面 上 出 现 了 多 种 CoAP 的 软件 实现 框架 ， 这 些 软件 实现 框架 既 可 以 运行 在 Windows 或 Linux 平 台 等 非 受 限 制 平 


=i 


台 ， 也 可 以 运行 在 诸如 Arduino 或 低 功 耗 无 线 传 感 网 终端 等 受 限制 设备 中 。 除 了 运行 平台 的 多 样 性 之 外 ， 用 户 还 可 以 使 用 不 同 的 编程 语言 实现 CoAP 的 各 种 功能 ， 这 些 编程 语言 包括 Java、C、Python 和 
Nodejjs 等 。 面 对 不 同 的 平台 与 不 同 的 使 用 场景 ， 各 种 开源 实现 框架 并 不 一 定 包括 CoAP 的 所 有 功能 ， 各 种 开源 实现 框架 往往 只 是 CoAP 众 多 标准 的 一 些 子 集 ， 在 实际 开发 的 过 程 中 需要 根据 团队 的 技术 偏好 
和 具体 需求 灵活 选择 。CoAP 实 现 框架 的 功能 概述 和 实现 特性 见 表 7-1。 


表 7-1 CoAP 软 件 实现 
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MU EWIT 观察 : “模式 
node-coap 服务 端 + 客户 站 erii MIT 


观察 者 模式 
Erbium 服务 端 + 客 户 端 块 传输 BSD 
DTLS 


本 章节 相关 示例 代码 均 位 于 GitHub 代 码 仓库 中 ， 用 户 可 以 使 用 git clone 指 令 复制 示例 代码 仓库 ， 代 码 仓库 的 地 址 如 下 : 
https://github.com/xukai871105/the beginning of coap 

其 中 : 

1) californium 入 门 示 例 相关 文件 位 于 simple_demo/cf_demo 目 录 中 。 

2) aiocoap 入 门 示例 相关 文件 位 于 simple_demo/aiocoap_demo 目 录 中 。 


3) node-coap 入 门 示 例 相关 文件 位 于 simple_demo/nodecoap_demo 目 录 中 。 


第 7 章 ”CoAP 软 件 实现 


7.1 本 章 主要 内 容 


本 章 将 介绍 多 种 CoAP 的 软件 实现 框架 。 随 着 CoAP 标 准 的 完善 和 开源 社区 的 不 断 努 力 ， 市 面 上 出 现 了 多 种 CoAP 的 软件 实现 框架 ， 这 些 软 件 实现 框架 既 可 以 运行 在 Windows 或 Linux 平 台 等 非 受 限制 平 
台 ， 也 可 以 运行 在 诸如 Arduino 或 低 功 耗 无 线 传 感 网 终端 等 受 限制 设备 中 。 除 了 运行 平台 的 多 样 性 之 外 ， 用 户 还 可 以 使 用 不 同 的 编程 语言 实现 CoAP 的 各 种 功能 ， 这 些 编程 语言 包括 Java、C、Python 和 
Nodejjs 等 。 面 对 不 同 的 平台 与 不 同 的 使 用 场景 ， 各 种 开源 实现 框架 并 不 一 定 包括 CoAP 的 所 有 功能 ， 各 种 开源 实现 框架 往往 只 是 CoAP 众 多 标准 的 一 些 子 集 ， 在 实际 开发 的 过 程 中 需要 根据 团队 的 技术 偏好 


和 具体 需求 灵活 选择 。CoAP 实 现 框架 的 功能 概述 和 实现 特性 见 表 7-1。 


表 7-1 CoAP 软 件 实现 


"ENT WR | BAIE "REGES 


观察 者 模式 

libcoap lll 45 im + EJ? Pg 块 传输 BSD/GPL 
DTLS 
观察 者 模式 

Californium 服务 病 十 客户 六 块 传输 EPL+EDL 
DTLS 


XL BE X 
块 传输 
观察 者 模式 
块 传输 


"ENT = 言 | maw EPR F 可 证 


观察 者 模式 
块 传输 


txThings HRI ng + 客户 应 MIT 


aiocoap Ht Amp + ARP ig MIT 


node-coap RI vg + ARE vg 


观察 者 模式 
Erbium 服务 疹 + 客 户 端 块 传输 BSD 
DTLS 


本 章节 相关 示例 代码 均 位 于 GitHub 代 码 仓库 中 ， 用 户 可 以 使 用 git clone 指 令 复制 示例 代码 仓库 ， 代 码 仓库 的 地 址 如 下 : 
https://github.com/xukai871105/the beginning of coap 

其 中 : 

1) californium 入 门 示 例 相关 文件 位 于 simple_demo/cf_demo 目 录 中 。 

2) aiocoap 入 门 示 例 相关 文件 位 于 simple_demo/aiocoap_demo 目 录 中 。 


3) node-coap 入 门 示 例 相 关 文件 位 于 simple_demo/nodecoap_demo 目 录 中 。 


71.2 libcoap 


与 Linux 平 台大 多 数 以 lib 开 头 的 工具 一 样 ，libcoap 是 一 款 简单 实用 但 功能 完整 的 开发 工具 。libcoap 不 但 提供 了 一 个 实用 的 coap-client 命 令 行 工 具 ， 也 提供 了 一 个 用 于 测试 目的 的 coap-server 命 令 行 工 


libcoap 提 供 一 个 动态 链接 库 libcoap.so 文 件 ， 用 户 可 以 使 用 libcoap 提 供 的 API 实 现 各 种 形式 的 coap-server 或 coap-client。libcoap 还 是 一 款 非常 高 效 的 命令 行 调试 工具 ，libcoap 提 供 的 coap-client 工 
具 相 当 于 HTTP 领 域 中 的 cURL 工具 ， 该 工具 可 以 实现 各 种 各 样 的 CoAP 请 求 。 更 多 信息 可 前 往 libcoap 的 官方 网 址 和 github 代 码 仓 库 获 得 。 


: libcoap 官 方 网 址 : https://libcoap.net/ 
: libcoap 代 码 仓 库 : https://github.com/obgm/libcoap 


libcoap 是 一 个 多 功能 的 工具 ， 虽 然 使 用 其 他 的 脚本 语言 例如 Python 和 Node.js 也 可 以 编写 出 功能 相同 的 CoAP 请 求 ， 但 libcoap 工 具 的 使 用 更 加 方便 灵活 。 


7.2.1 libcoap 安 装 

libcoap 的 安装 过 程 大 致 可 分 为 安装 依赖 项 、 获 取 源 代码 、 编 译 与 安装 这 4 个 步骤 。 可 通过 多 种 方式 获取 libcoap 的 源 代码 ， 若 在 Linux 主 机 中 已 经 安装 Git 工 具 ， 可 通过 “git clone” 方 式 获 得 libcoap 最 
新 代码 ; 若 尚 未 安装 git 工 具 ， 也 可 直接 下 载 libcoap 官 方 提供 的 稳定 版 源 代 码 。 

下 面 将 详细 说 明 如 何在 树 茵 派 3 代 中 通过 源 代码 的 方式 安装 libcoap， 其 他 Linux 主 机 中 安装 |ibcoap 的 步 又 与 树 莹 派 3 代 中 安装 |ibcoap 的 步骤 几乎 相同 。 

1. 安 装 依 赖 项 


通过 源 代码 方式 安装 libcoap 时 需要 提前 安装 automake、libtool 和 doxygen 等 依赖 工具 ， 在 树 莓 派 3 代 中 可 通过 apt-get 工 具 安 装 以 上 依赖 工具 。 


# 安装 依赖 工具 之 前 ， 请 先 使 用 apt-get _ update 指令 更 新 软件 源 
sudo apt-get update 

# 必 选 依赖 项 automake autoconf 
sudo apt-get install automake 
sudo apt-get install autoconf 
# 可 i 
S 
S 


udo apt-get install libtool 
udo apt-get install doxygen 


sudo apt-get install asciidoc 
sudo apt-get install cunit 


2. 获 取 源 代码 


通过 git 工 具 获取 最 新 libcoap 源 代码 。 


# 创建 一 个 文件 夹 ， 用 于 保存 1ibcoap 源 代码 
mkdir -p software 


# 进入 software 目 录 


git clone https://github.com/obgm/libcoap 


3. 编 译 与 安装 

libcoap 安 装 过 程 也 相对 简单 ， 但 具体 过 程 中 也 会 需要 处 理 一 些 问题 ， 需 要 根据 错误 提示 耐心 修正 。 一 般 来 说 libcoap 的 源 代码 安装 过 程 可 分 为 以 下 几 个 
1) ./autogen.sh 生 成 configure 可 执行 文件 。 

2) ./configure 配 置 软件 环境 。 

3) make 编 译 源 代码 。 

4) sudo make install 把 相关 头 文件 安 装 至 /usr/local/includeylibcoap， 把 相关 库 文件 安装 至 /usr/local/lib。 

5) sudo ldconfig 重 新 搜索 当前 系统 中 的 动态 链接 库 。 

在 控制 台中 依次 输入 以 下 指令 便 可 完成 libcoap 的 安装 。 


# 进入 Libcoap 源 代码 所 在 目录 
cd libcoap 
# 生成 构建 脚本 
./autogen.sh 
# 配置 软件 环境 
./configure --disable-documentation 
# 编译 libcoap 源 代码 
make 
# 执行 安装 过 程 
sudo make inst 
P Somme sa nds 


sudo ldconfig 


在 执行 configure 脚 本 时 可 输入 不 同 的 参数 。 
- --enable-tests 生 成 单元 测试 用 例 ， 若 启用 该 参数 需要 在 主机 中 提前 安装 cunit 测 试 框架 
--enable-examples 生 成 符合 POSIX 标 准 的 示例 ， 默 认 使 能 了 该 参数 。 


--enable-documentation 生 成 说 明文 档 ， 若 启用 该 选项 需要 在 主机 中 提前 安装 doxygen 和 a2x 工 具 。 默 认 设 置 中 已 经 使 能 该 参数 ， 所 以 需要 提前 在 主机 中 安装 doxygen 和 a2x 工 具 ， 否 则 可 输入 ./configute-- 
disable-documentation 以 禁止 生成 说 明文 档 。 


7.2.2 libcoap 使 用 详解 


libcoap 包 含 两 个 主要 的 命令 行 工 具 coap-server 和 coap-client。coap-server 工 具 可 快速 搭建 一 个 测试 用 途 的 CoAP 服 务 器 。coap-client 类 似 于 HTTP 中 常用 的 cURL 工具 ， 通 过 coap-client 可 以 设置 
CoAP 首 部 中 的 各 种 选项 ， 执 行 CoAP GET 或 PUT 请 求 等 。 下 面 分 coap-server 工 具 和 coap-client 工 具 两 部 分 说 明 如 何在 物 联 网 系统 开发 实战 中 使 用 libcoap 工 具 。 


1.coap-server 


(1) coap-server 用 法 说 明 


coap-server [-A address] [-p port] 


(2) coap-serverZ mi BH 
coap-server 的 参数 说 明 见 表 7-2。 


表 7-2 libcoap coap-setvet 工 具 参 数 说 明 


2 数 参数 说 明 


一 般 情 况 下 Linux 主机 有 多 个 IP 地址， 可 通过 该 参数 绑 定 其 中 的 一 个 I 地 
址 。 该 IP 地 址 可 以 是 IPv4 a eh 127.0.0.1， 也 可 以 是 IPv6 形式 的 回环 地 址 


Rs 更 可 以 是 本 机 的 IPv4 地 址 ， 例 如 192.168.0.103， 还 可 以 是 本 机 的 某 个 IPv6 
地 址 ， 例 如 2020:CA28:0:0:23:222:0:2900 
— 指定 侦 听 端口 号 ，CoAP 协议 默认 端口 号 为 5683，CoAP 加 密 通 信 的 默认 端口 


号 为 5684 
-y num 设置 调试 等 级 ， 默 认为 3 级 


(3) coap-server 用 法 示例 


下 面 通过 几 个 示例 说 明 coap-server 工 具 的 使 用 方法 。 


# 绑 定 本 地 IPv4 回 环 地 址 
coap-server -A 127.0.0.1 

# 绑 定 本 地 IPv6 回 环 地 址 
coap-server -A ::1 

# 绑 定 本 地 IPv4 地 址 ， 并 指定 端口 号 
coap-server -A 192.168.0.103 -p 5683 

# 绑 定 本 地 IPv6 地 址 

./coap-server -A 2020:CA28:0:0:23:222:0:2900 


若 已 知 Linux 主 机 的 IPv4 地 址 ， 推 荐 使 用 “coap-server-A 192.168.0.103-p 5683” 这 样 的 写法 ， 通 过 -A 参数 指定 主机 地 址 ， 通 过 -p 参 数 指定 服务 端口 号 。 
2.coap-client 
(1) coap-client 用 法 说 明 


相 比 于 coap-server 工 具 ，coap-client 工 具 的 参数 较 多 ，coap-client 的 具体 使 用 方法 如 下 : 


coap-client [-A typehttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/16571/OEBPS/Text/...] [-t type] [-b [num,]size] [-B seconds] [-e text 
[-u user] [-k key] URI 


(2) coap-client£ imi BH 
coap-client 的 参数 说 明 见 表 7-3。 


表 7-3 libcoap coap-clieht 工 具 参 数 说 明 


$ H 参数 说 明 
URI 符合 CoAP 标准 的 URI。 例 如 coap://wsncoap.org:5683/test 


设置 期 望 获得 的 媒体 类 型 ， 该 参数 既 可 以 是 一 个 符合 CoAP 媒体 类 型 标准 的 枚 举 值 ， 
也 可 以 是 相应 的 字符 串 描 述 

0 text/plain 

40 application/link-format 

4] application/link-format 


in 42 application/octet-stream 
47 application/exi 
50 application/json 
60 application/cbor 
推荐 在 实际 使 用 的 过 程 中 选择 枚 举 值 
指示 CoAP 负载 中 的 媒体 类 型 ， 和 -A 参数 相同 ， 该 参数 既 可 以 是 一 个 符合 CoAP W 
体 类 型 标准 的 枚 举 值 ， 也 可 以 是 相应 的 字符 串 描 述 
0 text/plain 
40  application/link-format 
4]  application/link-format 
-t type 


42 application/octet-stream 
47  application/exi 

50 application/json 

60 application/cbor 


推荐 在 实际 使 用 的 过 程 中 选择 枚 举 值 


$ 7 参数 说 了 明 


设置 CoAP 分 块 传输 大 小 。size 参数 用 于 设置 分 块 大 小 ， 可 选 值 16、32、64、128、 
256, 512 和 1024 55; num 参数 是 一 个 可 选 参 数 ， 该 参数 用 于 设置 分 块 传输 的 序号 偏 移 量 


-b [num,] size 


-B seconds 设置 CoAP 等 待 啊 应 的 超时 时 间 ， 单 位 为 秒 
-e text 设置 CoAP 请 求 负 载 ， 负 载 类 型 必须 为 文本 类 型 
-f file 把 指定 文件 作为 PUT 或 POST 方法 的 负载 ， 使 用 "-" 表示 STDIN (标准 输入 ) 
—" 指定 CoAP 请 求 方法 ，CoAP 请 求 方法 包括 GET, PUT, POST fl DELETE, WAH 
CoAP 请 求 方法 为 GET 
-N 发 送 NON 请 求 
-o file 把 CoAP 啊 应 写 和 人 到 指定 文件 中 ， 使 用 "-" 表示 STDOUT (标准 输出 ) 
指定 coap client 侦 听 端口 。 设 置 coap client 端口 之 前 需要 确定 该 端口 并 没有 被 其 他 应 
-p port 用 或 服务 占用 。 该 参数 为 设置 CoAP 客户 端 发 送 UDP 数据 时 使 用 的 端口 号 ， 请 不 要 与 
CoAP 服务 器 中 的 端口 号 相 混 淆 。 和 若 需 指定 服务 器 的 端口 号 可 在 URI 参数 中 指定 
启用 CoAP 观察 者 模式 使 用 ，duration 用 于 设置 观察 模式 开始 到 观察 者 模式 结束 的 时 
darain 间 间 隔 ， 单 位 为 秒 。 例 如 ，-s 10 表示 CoAP 客户 端 观察 某 个 资源 10 85, 10 秒 之 后 立刻 
结束 观察 。 请 注意 被 观察 者 将 源源 不 断 地 向 CoAP 观察 者 提供 数据 ， 数 据 之 间 的 时 间 间 
隅 由 被 观察 者 雇 定 ， 与 此 处 的 -s duration 没有 任何 关系 
-y num 指定 调试 信息 输出 等 级 。 默 认为 3 级 ， 最 高 为 9 级 
-T token 设置 用 户 自 定义 CoAP Token 
k key 该 功能 位 于 DTLS 分 支 ， 若 使 用 加 密 CoAP 功能 必须 提供 该 参数 。 


设置 用 户 的 预 分 至 密 钥 Pre-shared Key 


该 功能 位 于 DTLS 分 支 ， 知 使 用 加 密 CoAP 功能 必须 提供 该 参数 。 
-u user 设置 用 户 标识 符 。 由 于 CoAP Server 中 将 会 保存 多 个 预 分 享 密 钥 ， 每 个 预 分 享 密 钥 可 
能 属于 不 同 的 用 户 ，CoAP Server 通过 该 标识 符 确 定 具 体 用 户 的 Pre-shared Key 


(3) coap-client 用 法 示例 


下 面 通过 几 个 具体 示例 说 明 coap-client 的 使 用 方法 。 


# 使 用 CoAP get 方 法 访问 本 机 (CIPv4) .well-known/core 知 名 路 由 

coap-client -m get coap://127.0.0.1/.well-known/core 

# 使 用 CoAP get 方 法 访问 本 机 (CIPv6) .well-known/core 知 名 路 由 

coap-client -m get coap://[::1]/.well-known/core 

# 使 用 CoAP get 方 法 访问 192.168 .0. 6 主机 中 time 资 源 

coap-client -m get -T cafe coap://192.168.1.103/time 

# 使 用 CoAP put 方 法 更 新 192.168.1.103 主 机 中 的 time 资 源 

echo 1000 | coap-client -m put -T cafe coap://192.168.0.6/time -f - 


虽然 coap-client 的 参数 较 多 ， 但 使 用 过 程 并 不 复杂 。 首 先 ， 需 要 指定 CoAP 请 求 方法 ， 通 过 -m 参 数 便 可 设 定 CoAP 请 求 方法 ，CoAP 请 求 方法 包括 GET、PUT、POST 和 DELETE 四 种 ; 接着 ， 若 需要 指定 
CoAP 请 求 负载 ， 可 使 用 -e 参 数 设置 请 求 负载 ， 请 求 负 载 的 类 型 为 文本 类 型 ; 最 后 指定 CoAP 资 源 URI，coap-client 工 具 支 持 IPv6 地 址 ， 如 果 使 用 IPv6 形 式 的 主机 地 址 ， 那 么 IPv6 地 址 需要 包 应 在 中 括号 中 ， 
如 coap: //[fd00: : 212: 4b00: 42a: fd00]/time; 如 果 URI 还 包括 非 默认 端口 号 ， 请 注意 一 定 不 能 把 端口 号 也 放 在 中 括号 中 ， 如 下 的 CoAP URI 才 是 正确 的 : coap: //[fd00: : 212: 4b00: 42a: 
fd00]: 5684/time。 


7.2.3 libcoap 入 门 示例 


下 面 结合 树 长 派 3 代 给 出 一 个 libcoap 入 门 示例 ， 通 过 一 个 具体 的 示例 掌握 libcoap 的 使 用 方法 。 在 入 门 示例 中 包含 两 个 Linux 设 备 一 一 Linux 主 机 和 树 莓 派 ，Linux 主 机 作为 CoAP 客 户 端 ， 而 树 莓 派 3 代 作 
为 CoAP 服 务 器 ，libcoap 入 门 示例 的 网 络 结构 如 图 7-1 所 示 。 在 CoAP 服 务 器 中 提供 一 个 访问 系统 时 间 的 路 由 ， 使 用 树 莓 派 的 系统 时 间 是 因为 它 是 一 个 不 断 变化 的 参数 ， 也 就 是 说 每 次 CoAP 请 求 都 可 以 获得 
不 一 样 的 CoAP 响 应 。 通 过 这 种 变化 可 帮助 用 户 更 好 地 了 解 CoAP 本 身 ， 了 解 在 实际 的 应 用 中 哪些 细节 固定 不 变 ， 哪 些 细节 将 不 停 地 发 生变 化 。libcoap 入 门 示例 中 将 会 使 用 两 组 不 同 的 coap-client 指 令 : 


1) 获得 CoAP 服 务 器 公开 信息 coap-client-m get coap: //192.168.0.6/.well-known/core, 
2) 获得 CoAP 服 务 器 系统 时 间 coap-client-m get coap: //192.168.0.6/time, 


3) 启动 观察 者 模式 ， 观 察 CoAP 服 务 器 系统 时 间 coap-client-m get-s 100 coap: //192.168.0.6/time, 


注 
OE 为 了 成 功 运 行 libcoap 入 门 示 例 ， 需 要 在 Linux PC 主机 和 树 莽 派 中 正确 安装 libcoap。 


CoAP 客 户 端 一 Linux PC 主机 CoAP 服 务 右 一 一 树 每 派 3 代 


GET /.well-known/core 
OO 


</>,</time>,</async> 
< 


GET /time 
一 一 一 


/2 2.05 Content {系统 时 间 } 
E. LLL LL LLL 一 一 


Observe /time 
—————————— 


2.05 Content { 系 统 时 间 } 
192.168.0.3 二 192.108.0.0 
图 7-1 libcoap 入 门 示例 
1. 服 务 器 实现 


首先 在 树 莓 派 中 运行 coap-server 工 具 。coap-server 包 括 一 个 time 资 源 ， 通 过 GET 方 法 或 Observer 方法 访问 该 资源 可 获取 树 莓 派 的 系统 时 间 。 


# 运行 coap-server， 并 指定 树 莓 派 的 IF 地 址 
coap-server -A 192.168.0.6 


运行 coap-server 时 ，-A 人 参数 用 于 指定 Linux 主 机 IP 地 址 也 就 是 树 莓 派 的 I|P 地 址 ， 本 例 中 树 莓 派 的 1Pv4 地 址 为 192.168.0.6。 知 不 清楚 树 莓 派 的 |P 地 址 ， 可 在 树 莓 派 中 使 用 fconfig 指 令 查看 。 


(1) 访问 /.well-known/core 


在 Linux PC 主机 中 重新 打开 一 个 控制 台 ， 在 控制 台中 输入 以 下 命令 。 


# 运行 Coap-client， 指 定 CoAP Server IP 地 址 
coap-client -m get coap://192.168.0.6/.well-known/core 


: -m get 通 过 -m 参 数 指 定 访问 该 资源 的 CoAP 方 法 ， 此 处 为 GET 方 法 。 
访问 URI 为 coap: //192.168.0.6/.well-known/cote o 


Linux PC 主机 将 获取 以 下 内 容 : 


v:1 t:CON c:GET i:2836 {} [ ] 

«/»;title-"General Info";ct-0, 
«/time»;if-"clock";rt-"Ticks";title-"Internal Clock";ct-0;obs, 
«/async»;ct-0 


v: 1t: CONc: GET i: 2836 给 出 CoAP 请 求 的 首部 信息 ，v: 1 代表 CoAP 版 本 编号 ， 无 论 如 何 CoAP 的 版 本 编号 均 为 1; t: CON 表 示 CoAP 请 求 为 CON 类 型 请 求 ; c: 


2836 表 示 报 文 序号 为 2836。 
- 访问 .well-known/core 可 获取 服务 器 中 所 有 资源 的 提示 信息 ， 该 CoAP 服 务 器 中 包含 三 个 资源 ， 分 别 为 </>、</time> 和 </asyn>。 
</>; title="General Info"; ct=0: 车 访问 “/” 可 获取 该 CoAP 服 务 器 的 概要 信息 ， 概 要 信息 的 媒体 类 型 为 文本 类 型 。 
- </time>; ifz"clock"; rt-"Ticks"; title2"Internal Clock"; ct=0; obs: 相 比 于 “/” 资 源 ，time 资 源 要 复杂 一 些 ，time 资 源 包含 “obs” 属 性 表示 该 资源 可 以 被 观察 。 
(2) 通过 GET 方 法 获取 系统 时 间 
在 Linux PC 主机 控制 台中 运行 以 下 指令 。 


# 运行 Coap-client， 指 定 CoAP 服 务 器 IP 地 址 
coap-client -m get coap://192.168.0.6/time 


GET 表 示 请 求 方法 为 GET 请 求 ; d: 


: -m get 通 过 -m 参 数 指定 访问 该 资源 的 CoAP 方 法 ， 此 处 仍 为 GET 方 法 。 
243 问 URI 为 coap: //192.168.0.6/time。 
运行 于 树 莓 派 3 代 中 的 CoAP 服 务 器 将 会 返回 以 下 内 容 。 


v:l t:CON c:GET i:4b5d {} [ ] 
Aug 01 06:07:02 


v: 1t: CONc: GET i: 4b5d 给 出 了 CoAP 请 求 的 首部 信息 ，v: 1 代表 CoAP 版 本 编号 ; t: CON 表 示 CoAP 请 求 为 CON 类 型 请 求 ; c: GET 表 示 请 求 方法 为 GET 请 求 ; i: 4b5d 表 示 报 文 编号 为 4b5d。 


: Aug0106: 07: 02 表 示 此 时 树 莽 派 3 的 系统 时 间 。 


由 于 time 服 务 中 并 没有 考虑 时 区 和 时 间 表 示 方 式 等 因素 ， 所 以 COAP 响 应 中 树 莓 派 的 系统 时 间 并 不 一 定 与 当前 时 间 完 全 吻合 ， 但 这 并 没有 太 大 的 关系 ， 此 处 仅仅 是 为 了 说 明 libcoap 可 以 在 Linux 主 机 和 
树 莓 派 中 正常 工作 。 


(3) 通过 Observer 观察 系统 时 间 


通过 Observer 观察 CoAP 服 务 器 中 的 time 资 源 ， 在 Linux PC 控制 台 输 入 以 下 指令 : 


# 运行 coap-client， 指 定 CoAP Server IP 地 址 
coap-client -m get -s 100 coap://192.168.0.6/time 


: -m get 通 过 -m 参 数 指定 访问 该 资源 的 CoAP 方 法 ，CoAP 中 Obsetvet 也 可 以 理解 为 一 种 特殊 的 GET 方 法 ， 但 在 libcoap 中 执行 Obsetvet 一 定 要 在 coap-clieht 指 令 中 增加 -s 参 数 。 


一 s 100 表 示 持 续 观 察 time 资 源 100 秒 ， 在 这 100 秒 的 时 间 内 CoAP 服 务 器 将 向 CoAP 客 户 端 源源 不 断 地 返回 树 莽 派 3 代 内 部 的 系统 时 间 。 


` 访问 URI 为 : coap: //192.168.0.6/time。 


} 


Linux PC 控制 台 将 获得 以 下 内 容 : 


v:1 t:CON c:GET i:cb5a {} [ ] 
Dec 10 08:39:54 

Dec 10 08:39:56 

# 省 略 若干 内 容 

Dec 10 08:41:20 

Dec 10 08:41:22 


通过 Linux PC 控制 台 的 输出 可 以 发 现 ， 运 行 于 树 莓 派 中 的 CoAP 服 务 器 每 隔 2 秒 钟 向 CoAP 客 户 端 返回 指示 内 容 ， 在 CoAP 观 察 者 模式 中 指示 报 文 的 时 间 间 隔 由 CoAP 服 务 器 决定 ， 一 般 在 指示 报 文中 包含 
Max-Age 选 项 ， 该 选项 用 于 告知 CoAP 客 户 端 被 观察 资源 的 更 新 周期 。 


7.3 alocoap 
Python 是 一 款 非 常 容易 学 习 的 解释 性 语言 ， 用 户 编写 脚本 可 以 直接 被 运行 ， 而 不 需要 先 整体 编译 成 机 器 代码 。 此 外 Python 安装 和 运行 环境 设置 也 非常 容易 ， 开 发 者 社区 相对 活跃 。Python 2 和 Python 
3 也 是 开源 硬件 树 莹 派 的 默认 安装 软件 。 


在 Python 领域 中 也 有 不 少 CoAP 的 实现 框架 ， 其 中 txThingl 和 aiocoap 四 使 用 较为 广泛 。txThing 依 赖 Python 2.7， 采 用 Twisted 框 架 实现 。 而 aiocoap 采 用 Python 3 开发 ， 使 用 Python 3.4 版 本 之 后 自 
的 异步 IO 框架 asyncio 实 现 。aiocoap 和 txthing 有 继承 关系 ，aiocoap 继 承 了 txThing 的 绝 大 部 分 功能 ， 并 把 异步 1O 框 架 由 Twisted 改 为 Python 3.4 之 后 自 带 的 asyncio。 


di 


[1] https:/ /github.com/mwasilak/txThings 。 


[2] https:/ / github.com/chrysn/aiocoap. 


7.3.1 aiocoap ca 


1. 源 代码 方式 安装 Python 3.5 


aiocoap 入 门 示例 依赖 Python 3.5， 所 以 运行 本 节 入 门 示例 之 前 需 在 树 莓 派 中 安装 Python 3.5 或 更 高 版 本 ， 下 面 说 明 如 何 通过 源 代码 方式 安装 Python 3.5.2， 在 树 莓 派 中 新 建 控制 人 台 ， 在 控制 台中 依次 
输入 以 下 指令 : 


# 获取 Python 3.5 源 代码 

wget https://www.python.org/ftp/python/3.5.2/Python-3.5.2.tgz 
# 解压 Python 3.5 源 代码 

tar -zxvf Python-3.5.2.tgz 

# 进入 Python 3.5 目 录 


# 生成 makefile 文 件 
./configure 

# 编译 源 代码 

make 

# 安装 Python3.5 
sudo make install 


2. 通 过 pip 工 具 安装 aiocoap 
pip 工 具 是 Python 3 的 默认 包 管 理工 具 ， 可 通过 pip 工 具 安 装 aiocoap。 在 树 莓 派 控制 台中 依次 输入 以 下 指令 便 可 完成 aiocoap 的 安装 。 


# 通过 Pip3 安 装 aiocoap 

sudo pip3 install aiocoap 

# 通过 pip3 安 装 aiocoap 的 依赖 项 LinkHeader 
sudo pip3 install LinkHeader 


由 于 树 莓 派 中 已 经 安装 了 Python 2， 所 以 树 莓 派 中 已 经 包含 了 两 个 不 同 版 本 的 pip 工 具 。 如 果 需 要 把 扩展 库 安装 到 Python 3 的 lib 目 录 中 需要 使 用 pip3 工 具 ， 若 直接 使 用 pip 工 具 那 么 扩展 库 将 被 安装 至 
Python 2 的 lib 目 录 中 ， 此 时 将 无 法 使 用 本 节 相 关 的 aiocoap 示 例 。 除 了 安装 aiocoap 之 外 ， 还 需要 安装 aiocoap 的 依赖 库 LinkHeader。 若 已 经 安装 过 aiocoap， 可 通过 upgrade 指 令 更 新 aiocoap， 在 控制 台 
中 输入 以 下 指令 便 可 完成 更 新 操作 : 


# 通过 pip3 工 具 更 新 aiocoap 
sudo pip3 install aiocoap --upgrade 


7.3.0 aiocoap 入 门 示例 


下 面 通过 两 个 示例 说 明 如 何 使 用 aiocoap。 人 入 门 示例 中 包括 两 台 设备 ， 这 两 台 设 备 分 别 扮演 CoAP 客 户 端 和 CoAP 服 务 器 的 角色 ， 此 处 树 莓 派 3 代 作 为 CoAP 服 务 器 ， 另 一 台 Linux PC 主机 作为 CoAP 客 户 
端 。 在 运行 入 门 示例 之 前 需要 保证 树 莓 派 和 Linux PC 主机 都 已 经 正确 安装 合适 版 本 Python 3， 而 且 Linux 主 机 可 以 通过 网 络 正 常 访问 树 莓 派 3 代 。 人 入 门 示例 中 树 莓 派 3 代 作 为 服务 器 将 运行 test-server.py， 而 


Linux PC 主机 作为 服务 器 端 将 运行 test-client.py。 树 莓 派 中 CoAP 服 务 器 提供 一 个 系统 时 间 服 务 (资源 ) ， 通 过 coap: /192.168.0.6/time 便 可 访问 该 资源 ，CoAP 服 务 器 中 的 系统 时 间 资 源 仅 文 持 GET 方 
法 。aiocoap 入 门 示例 的 大 致 工作 流程 如 图 7-2 所 示 。 


客户 端 test-client.py Hi 5 n test-server.py 


GET /time 
—— 


2.05 Content 
am “2016-12-17 22:04:57” 


/NN < 


Linux EHL 


图 7-2 ”aiocoap 入 门 示例 
1. 服 务 器 实现 
test-server.py 具 体 代码 如 下 : 


代码 清单 7-1 test-server.py 


#!/usr/bin/env python3 
import datetime 

import logging 

import asyncio 

aiocoap.resource as resource 
aiocoap 


impor! 
impor! 


class TimeResource (resource.Resource): 
def init (self): 
super(TimeResource, self). init () 


async def render get(self, request): 
payload - 

datetime.datetime.now().strftime ("$Y-$m-£d $H:£2M:$S").encode('ascii!') 
return aiocoap.Message (code-aiocoap.Code.CONTENT, payload-payload) 


logging.basicConfig (level-logging.INFO) 
logging.getLogger ("coap-server").setLevel (logging.DEBUG) 


def main(): 
root = resource.Site() 
root.add resource(('.well-known', 'core'), 


resource.WKCResource (root.get resources as linkheader))root.add resource(('time',), TimeResource|()) 
asyncio.Task(aiocoap.Context.create server context (root)) 
asyncio.get event loop().run forever () 


Tf name == " main 
main () 


(1) 定义 TimeResource 资 源 
CoAP 服 务 器 提供 一 个 系统 时 间 服 务 (资源 ) ，test-server.py 中 定义 一 个 TimeResource 类 ， 该 类 继承 自 resource.Resource 类 。 
(2) 处 理 GET 方 法 


系统 时 间 服 务 仅 支 持 GET 方 法 ， 若 CoAP 服 务 器 接收 到 符合 该 资源 的 GET 请 求 ， 将 调用 TimeResource 中 的 render_get 方 法 。 在 render_get 方 法 中 ， 通 过 datetime 取 出 树 芍 派 内 系统 时 间 ， 并 使 用 
strftime 方 法 将 系统 时 间 格 式 化 为 “年 -月 -日 时 : 分 : 秒 ” 这 样 的 形式 ， 最 后 调用 aiocoap.Message 方 法 生成 CoAP 响 应 。 


async def render get(self, request): 
payload = datetime.datetime.now().strftime ("$Y-£m-$d $H:$M:$S").encode('ascii') 
return aiocoap.Message (code-aiocoap.Code.CONTENT, payload-payload) 


(3) 增加 TimeResource 资 源 


完成 TimeResource 资 源 定义 之 后 便 可 把 该 资源 加 入 到 服务 器 根 站 点 中 。 除 了 加 入 Time-Resource 资 源 之 外 ，test-server.py 还 增加 了 well-known 资 源 ，well-known 资 源 的 具体 内 容 和 处 理 方法 将 由 
aiocoap 自 动 生 成 ， 并 不 需要 编写 额外 的 代码 。 


root.add resource(('.well-known', 'core') 
resource.WKCResource (root.get resources as linkheader)) 
root.add resource(('time',), TimeResource()) 


(4) 循环 处 理 CoAP 请 求 


最 后 利用 python 3.4 之 后 自 带 的 asyncio 异 步 处 理 框架 处 理 来 自 不 同 客户 端的 CoAP 请 求 。 


asyncio.Task(aiocoap.Context.create server context (root)) 
asyncio.get event loop().run forever () 


test-client.py 具 体 代 码 如 下 : 


代码 清单 7-2 test-client.py 


#!/usr/bin/env Python3 


import logging 
import asyncio 


import aiocoap 


logging.basicConfig (level-logging.INFO) 


async def main(): 
protocol = await aiocoap.Context.create client context () 
request = aiocoap.Message (code-aiocoap.Code.GET, uri-'coap:// 
«raspberry ip address»/time') 


try: 


response = await protocol.request (request) .response 
except Exception as e: 
print('Failed to fetch resource: ') 
print (e) 
else: 
print('Result: $sMn$r' $ (response.code, response.payload)) 


if name == " main 
asyncio.get event loop().run until complete (main()) 


下 面 说 明 test-client 的 具体 工作 流程 。 
(1) 构造 CoAP 请 求 


构造 CoAP 请 求 时 需要 指定 CoAP 请 求 方法 和 URI，test-client.py 中 CoAP 的 请 求 方法 为 GET 方 法 ，URI 为 coap: //<raspberry ip_address>/time。 请 根据 实际 运行 环境 替换 <raspberry ip address» 7j 
实际 的 树 莓 派 I1Pv4 地 址 。 


request = aiocoap.Message (code-aiocoap.Code.GET, uri-'coap://192.168.0.6/time') 


(2) 发 送 CoAP 请 求 并 输出 结果 


通过 protocol.redquest 方 法 发 送 构造 CoAP 请 求 ， 获 得 CoAP 响 应 之 后 把 响应 码 和 响应 负载 通过 print 函 数 输出 至 控制 台中 。 


try: 
response = await protocol.request (request).response 
except Exception as e: 
print('Failed to fetch resource: ') 
print (e) 
else: 
print('Result: $sWMn$r'£(response.code, response.payload)) 


3. 动 手 测试 

完成 test-server.py 和 test-client.py 之 后 便 可 动手 进行 测试 ， 在 树 莓 派 3 代 中 运行 test-server.py， 在 另 一 台 Linux PC 主机 中 运行 test-client.py。 
(1) 运行 CoAP 服 务 器 

在 树 莓 派 3 代 控制 台中 先 运行 test-server.py。 


Python3 test-server.py 
(2) 获取 TimeResource 资 源 

然后 在 另 一 台 Linux PC 主机 中 运行 test-client.py。 

Python3 test-client.py 

若 test-client.py 成 功 运行 ， 那 么 控制 台 将 会 获得 以 下 输出 内 容 : 


Result: 2.05 Content 
5'2016-08-01 17:30:24' 


2.05 Content 表 示 CoAP 服 务 器 成 功 响 应 了 CoAP 客 户 端的 请 求 ，CoAP 响 应 负载 中 包含 树 莓 派 3 代 的 系统 时 间 ， 系 统 时 间 采 用 “Y-m-d H: M: S”， 也 就 是 “年 -月 -日 时 : 分 : 秒 ” 这 样 的 格式 。 简 单 
比较 一 下 系统 时 间 便 可 验证 CoAP 服 务 器 是 否 工作 正常 。 


7.3.3 aiocoap 块 传输 示例 


在 入 门 示例 的 CoAP 服 务 中 仅 包 含 一 个 TimeResource 资 源 ， 本 节 在 test-coap.py 的 基础 上 再 增加 一 个 块 (Block) 资源 。 该 资源 的 响应 负载 内 容 较 长 ，CoAP 客 户 端 可 通过 分 块 传输 的 方式 获取 该 资源 ， 
分 块 的 大 小 由 CoAP 客 户 端 定义 。 如 图 7-3 所 示 。 


4 A9mtest-client.py 


1. 服 务 器 实现 


更 改 之 后 的 test-server.py 的 具体 代码 如 下 : 


代码 清单 7-3 ”更 改 之 后 的 test-server.py 


#!/usr/bin/env Python3 


import datetime 
import logging 
import asyncio 
import aiocoap.resource as resource 
import aiocoap 


class TimeResource (resource.Resource): 


def init (self): 
super (TimeResource, 
async def render get (se 


datetime.datetime.now() 


payload - 


self). 


| init 


, 


request): 


.Strf 


class BlockResource (resource.Resource): 


time ("£Y-$m-$d $H 
return aiocoap.Message (code-aiocoap.Code.CONT 


IRI iR xmitest-server.py 


GET /other/block 


一 


二 一 


一 一 一 一 


= 


图 7-3 ”aiocoap 分 块 传输 示例 


0 


:%M:%S") .encode ('ascii') 


ENT, payload-payload) 


def init (self): 
super(BlockResource, self). init () 
self.content = ("123456789ABCDEFAn" * 16).encode ("ascii") 
async def render get(self, request): 
return aiocoap.Message (code-aiocoap.Code.CONTENT, payload-self.content) 
logging.basicConfig (level-logging.INFO) 
logging.getLogger ("coap-server").setLevel (logging.DEBUG) 
def main(): 
root = resource.Site() 
root.add resource(('.well-known', 'core'), 
resource.WKCResource (root.get resources as linkheader)) 
root.add resource(('time',), TimeResource()) 
root.add resource(('other', 'block'), BlockResource|()) 
asyncio.Task(aiocoap.Context.create server context (root)) 
asyncio.get event loop().run forever () 
if name == " main ": 
main () 


(1) 增加 BlockResource 资 源 


在 test-server.py 中 增加 一 个 BlockResource 类 ， 该 


(2) 定义 响应 内 容 


类 与 TimeResource 相 同 也 继承 自 resource.Resource 类 。 


在 BlockResource 类 的 构造 函数 中 定义 一 个 self.content 成 员 ， 在 GET 处 理 函 数 render_ get 中 把 self.content 作 为 响应 负载 返回 至 CoAP 客 户 端 。self.content 由 16 组 相同 的 字符 


串 “123456789ABCDEF\n” 组 成 ， 单 组 字符 串 长 度 为 16，self.content 的 总 长 为 256 字 节 。 若 CoAP 客 户 


要 4 次 分 包 传输 。 


class 
def 


asyn 


init (sel 
super (l 
self.content - 


c def render get 


E): 


2. 动 手 测试 


(1) 运行 CoAP 服 务 器 


BlockResource, 
("123456789Al 
(self 
return aiocoap.Message (code-aiocoap.Code.CONT 


BlockResource (resource.Resource): 


| init — 
BCDEFAn" 
, request): 


sel 


f). 


zm 
, Hom 


端 设置 的 响应 分 包 大 小 为 32， 共 需要 8 次 分 块 传输 ; 若 CoAP 客 户 端 设置 的 响应 分 包 大 小 为 64 


() 


* 16) .encode ("ascii") 


ENT, payload-self.content) 


修改 test-server.py 之 后 ， 在 树 莓 派 3 代 中 新 建 一 个 控制 台 并 在 控制 台中 重新 运行 test-server.py。 


Python3 test-server.py 


(2) 运行 CoAP 客 户 端 


此 处 使 用 libcoap 中 的 coap-client 工 具 作 为 CoAP 客 户 端 ， 在 Linux PC 控制 台中 输入 : 


coap-client -m get -b 64 coap://192.168.0.6/other/block 


| -m get 表 示 CoAP 请 求 方 法 为 GET 方 法 。 


Cb 64 表 示 CoAP 请 求 中 包含 块 传输 选项 ， 分 包 大 小 为 64。 


若 CoAP 服 务 器 正确 处 理 客 户 端 请 求 ，Linux 控 制 台 将 会 获得 以 下 内 容 : 


v:1 t:CON c:GET i:17ed {} [ ] 
123456789ABCDEF 
123456789ABCDEF 
123456789ABCDEF 
123456789ABCDEF 
v:1 t:CON c:GET i:17ee {} [ ] 
123456789ABCDEF 
123456789ABCDEF 
123456789ABCDEF 
123456789ABCDEF 
V:l t:CON c:GET i:17ef {} [ ] 
123456789ABCDEF 
123456789ABCDEF 
123456789ABCDEF 
123456789ABCDEF 
v:l t:CON c:GET i:17f0 {} [ ] 
123456789ABCDEF 
123456789ABCDEF 
123456789ABCDEF 
123456789ABCDEF 


从 控制 台 的 输出 内 容 可 以 发现 ，CoAP 服 务 器 共 返 回 256 字 节 内 容 ， 分 4 次 传输 至 客户 端 ， 每 组 大 小 为 64 字 节 。 通 过 调整 -b 参 数 可 修改 分 块 传输 大 小 ， 例 如 当 设 置 “-b 32” 时 ，CoAP 服 务 器 将 把 响应 分 
成 8 组 并 依次 传输 至 客户 端 。 


7.3.4 aiocoap 树 莓 派 GPIO 示 例 


Python 作为 一 款 通 用 的 计算 机 编程 语言 具有 很 好 的 硬件 操作 能 力 。 作 为 树 莓 派 中 的 默认 编程 语言 ， 使 用 Python 可 操作 树 莓 派 的 GBPIO、SPI、UART 和 12C 等 外 设 ， 通 过 这 些 外 设 不 但 可 以 控制 执行 机 
构 ， 也 可 以 获取 传感器 检测 结果 。 本 小 节 以 GPIO 为 例 ， 说 明 如 何 把 CoAP 与 GPIO 控 制 结合 在 一 起 。 


在 aiocoap 树 莓 派 GPIO 示 例 中 ， 树 莓 派 3 代 依然 作为 CoAP 服 务 器 而 另 一 台 Linux 主 机 作为 CoAP 客 户 端 。 树 莓 派 中 使 用 RPi.GPIO 扩 展 库 控制 LED， 该 LED 与 树 莓 派 扩展 插座 的 第 1 脚 相连 ， 高 电 平 可 打开 
LED， 低 电 平 可 熄灭 LED。CoAP 客 户 端 通过 JSON 类 型 负载 控制 LED 点 亮 或 煌 灭 ，JSON 负 载 包含 一 组 JSON 对 象 ， 对 象 的 键 名 为 “value” ， 键 值 为 整数 类 型 的 0 或 1，0 表 示 LED 熄 灭 而 1 表示 LED 点 亮 。 
aiocoap 树 莓 派 GPIO 示 例如 图 7-4 所 示 。 


4  fmtest-client.py 服务 大 test-server.py 


PUT /gplo 
{“value”: 1} © 


2.04 Changed 


SE PUT /gpio O 


/ES fvalue":0) 


2.04 Changed 


FUAREUK 


图 7-4  aiocoapfd 9e J& GPIO zr 45] 
1. 准 备 工作 
一 般 情况 下 ， 树 莓 派 3 代 中 已 经 默认 安装 了 RPi.GPIO， 如 果 需 要 把 RPi.GPIO 升 级 到 最 新 版 本 ， 可 在 树 莓 派 控 制 台 中 输入 以 下 指令 : 
2. 服 务 器 实现 
代码 清单 7-4 rpi gpio server.py 


#!/usr/bin/env python3 
import logging 


import asyncio 
import aiocoap.resource as resource 
import aiocoap 


import RPi.GPIO as GPIO 
import json 


led pin - 11 

class GPIOResource (resource.Resource): 
def init (self): 

super (GPIOResource, Se | init () 

led status = ('value': 0} 

self.content - json.dumps (led status).encode ("ascii") 


async def render get(self, request): 
return aiocoap.Message (code-aiocoap.Code.CONTENT, payload-self.content) 


async def render put(self, request): 
print('PUT payload: $s' $ request.payloaQ) 

led status = json.loads (request.payload.decode|()) 

if led status['value'] — 1 : 

print('open led!) 

GPIO.output (led pin, GPIO.HIGH) 

else : 
print ('close led') 
GPIO.output (led pin, GPIO.LOW) 

self.content = json.dumps (led status) .encode ("ascii") 

return aiocoap.Message (code-aiocoap.Code.CHANGED, payload-self.content) 


logging.basicConfig (level-logging.INFO) 
logging.getLogger ("coap-server").setLevel (logging.DEBUG) 


def main(): 
# setup gpio 
GPIO.setmode (GPIO.BOARD) 
GPIO. setup (led pin, GPIO.OUT) 


# Resource tree creation 
root = resource.Site() 
root.add resource(('.well-known', 'core'), 
resource.WKCResource (root.get resources as linkheader)) 
root.add resource(('gpio',), GPIOResource()) 
asyncio.Task(aiocoap.Context.create server context (root)) 
asyncio.get event loop().run forever () 


". 
. 


if name == " main 
main () 


( 1 ) 设置 G PIO 为 输出 状态 


通过 GPIO.setmode (GPIO.BOARD) 设置 树 莓 派 GPIO 编 号 方式 ， 并 通过 GPIO.setup 把 第 11 引 脚 设置 为 输出 状态 。 


import RPi.GPIO as GPIO 


led pin - 11 
def main(): 

# setup gpio 
Wi， BOARD) 
PIO.setup(led pin, GPIO.OUT) 
# ARR 


(2) 处 理 PUT 请 求 


CoAP 请 求 负 载 为 JJON 格 式 ， 例 如 { "value" : 1}。PUT 请 求 处 理 函 数 中 request.payload 为 bytes 类 型 ， 可 通过 decode 函 数 把 bytes 类 型 转换 为 字符 串 类 型 ， 再 通过 json.loads 函 数 转化 为 Python 字典 
类 型 ，Python 字 典 类 型 和 JSON 类 型 存在 直接 对 应 关系 。led status 对 应 LED 具 体 状 态 ，led status[value'] 对 一 个 LED 打 开 或 关闭 状态 ， 若 led status[value'"] 等 于 1， 则 打开 LED。 


async def render put (self, request): 
print('PUT payload: $s' $ request.payloag) 

led status = json. ma cde dE payload.decode()) 

if led status['value'] — : 

print ('open led') 

GPIO.output (led pin, GPIO.HIGH) 

else : 
print('close led') 
GPIO.output (led pin, GPIO.LOW) 

self.content = json.dumps (led status) .encode ("ascii") 

return aiocoap.Message (code-aiocoap.Code.CHANGED, payload-self.content) 


3. 动 手 测试 
(1) 运行 CoAP 服 务 器 


在 树 莓 派 3 代 中 新 建 一 个 控制 人 台 ， 在 控制 台中 输入 : 


Python3 rpi gpio server.py 


(2) 运行 CoAP 客 户 端 

{Linux PC 主机 中 通过 coap-client 工 具 点 亮 LED， 可 输入 以 下 指令 点 亮 LED: 
coap-client -m put -e (V'valueV':1) coap://192.168.0.6/gpio 

: -m put 表 示 CoAP 请 求 方法 为 PUT 方法 。 

: -e{\"value\": 1} 表 示 CoAP 请 求 负载 为 字符 串 形 式 的 {\"'value\": 1}。 
知 熄 灭 LED， 可 以 把 请 求 负载 中 的 “1” 改 为 “0”。 


coap-client -m put -e (V'valueV':0) coap://192.168.0.6/gpio 


7.4 node-coap 
Node.js AAAS, Node.js—BRgFH-T Web3T&, (Bi&B&ziNodeJjsZKEHSZNBAURTUTUISTEEBJS37J, Node jst TRARRE. Node.js&&—/^&& T Chrome V85|£& 
Javascript 运 行 环境 。Node.js 使 用 了 事件 驱动 、 非 阻塞 式 MO 的 模型 ，Node.js 既 轻 量 又 高 效 ， 是 新 一 代 计 算 机 开发 语言 。 与 前 面 介 绍 的 Python 3 相似 ，Node.js 也 有 自己 的 包 管 理工 具 一 一 npm。 


node-coap[] 便 是 使 用 Node,js 语 言 实现 CoApP 的 开源 框架 ， 相 比 于 语法 略 显 沉 重 的 Java，Node.js 更 易于 学 习 ， 只 编写 少量 的 代码 便 可 实现 各 种 各 样 不 同 功能 的 CoAP 服 务 器 或 客户 端 。 与 Python 相 
似 ，Node.js 非 常 适合 CoAP 初 学 者 。 


[1] https:/ /github.com/mcollina/node-coap. 


714.4 Node.js 安 装 


由 于 NodeJjs 并 不 是 树 莓 派 的 默认 安装 软件 ， 所 以 开始 node-coap 入 门 示例 之 前 需 在 树 莓 派 中 正确 安装 Node.js。 


Node,js 可 以 在 多 种 平台 运行 ，NodeJjs 提 供 了 各 种 不 同 平台 的 安装 包 和 源 代码 包 。 本 节 将 介绍 如 何在 树 莓 派 3 代 中 安装 Node.js， 树 莓 派 3 代 中 安装 Node.js 的 方法 与 其 他 Linux 主 机 中 安装 NodeJjs 的 方法 
非常 相似 ， 可 以 分 为 软 链接 方式 安装 、 代 码 仓 库 安装 和 源 代码 安装 等 ， 本 节 将 详细 介绍 这 三 种 方法 。 而 Windows 平 台 的 安装 方法 非常 简单 ， 本 节 将 不 再 详细 说 明 。 由 于 Node.js 的 版 本 众多 ， 本 节 以 4.7.0 版 
本 为 例 说 明 Node.js 安 装 过 程 。 


1 软 链接 方式 安装 Nodejs 


下 面 介 绍 如 何在 树 莓 派 3 中 使 用 软 链接 方式 安装 Nodejs。Nodejjs 提 供 了 ARM 平 台 安 装 包 文 件 ， 这 些 安装 包 可 分 为 三 种 不 同 的 ARM 指 令 集 一 ARMVv6、ARMYVv7 和 ARMVv8。 树 莓 派 1 代 B+ 需 选择 
ARMYv6 版 本 安装 包 ， 更 高 硬件 版 本 的 树 莓 派 需 选择 ARMYV7 版 本 安装 包 。 若 不 清楚 树 莓 派 的 ARM 指 令 集 版 本 也 没有 关系 ， 可 碍 看 proc/cpuinfo 文 件 获得 更 多 信息 的 信息 ， 如 图 7-5 所 示 为 树 长 派 1 代 B+ 的 
CPU 版 本 信息 ， 而 如 图 7-6 所 示 为 树 莓 派 3 代 的 CPU 版 本 信息 。 


EP pi@raspberry: ~ 


pi@raspberry: cat /proc/cpuinfo 

processor A 

model name : ARMv6-compatible processor rev 7 (v61) 
BogoMIPS > 2.00 

Features : half thumb fastmult vfp edsp java tls 
CPU implementer : 0x41 

CPU architecture: 


CPU variant 
CPU part 
CPU revision 


Hardware : BCM2708 

Revision : 0010 

Serial : 00000000f4275357 
pigraspberry: 


图 7-5” 树 甘 派 1 代 B+CPU 信 息 


在 树 葡 派 3 中 通过 软 链接 方式 安装 Node.js， 具 体 步骤 如 下 : 


# 新 建 一 个 文件 夹 用 于 存放 Node .js 安装 文件 

mkdir -p software 

# 进入 software 目 录 

cd software 

# 获取 Node .js 安装 包 指定 ARM 指 令 集 为 armv7 

wget https://nodejs.org/dist/v4.7.0/node-v4.7.0-linux-armv7l.tar.xz 

# 解压 Node .js 安装 包 

xz -d node-v4.7.0-linux-armv7l.tar.xz 

tar -xf node-v4.7.0-linux-armv7l.tar 

# 为 node 和 npm 创 建 软 链接 

sudo ln -s ~/software/node-v4.7.0-linux-armv7l/bin/node /usr/local/bin/node 
sudo ln -s -/software/node-v4.7.0-linux-armv71/bin/npm /usr/local/bin/npm 


EP piQxukai-rpi: ~ 一 o X 


pigxukai-rpi:- $ cat /proc/cpuinfo 

processor H 

model name : ARMv7 Processor rev 4 (v71) 
BogoMIPS : 38.40 

Features : half thumb fastmult vfp edsp neon vfpv3 tls vfpv4 idiva idivt 
vfpd32 lpae m crc32 

CPU implementer : 0x41 

CPU architecture: 

CPU variant 

CPU part 

CPU revision 


processor 

model name : ARMv7 Processor rev 4 (v71) 

BogoMIPS : 38.40 

Features : half thumb fastmult vfp edsp neon vfpv3 tls vfpv4 idiva idivt 
vfpd32 lpae — crc32 

CPU implementer : 0x41 

CPU architecture: 

CPU variant 

CPU part 

CPU revision 


E7-6 WTA JKSINCPUAS & 


除了 软 链接 方式 安装 Node.js 之 外 ， 也 可 使 用 代码 仓库 方式 安装 Nodejs， 本 书 推荐 使 用 代码 仓库 方式 安装 Nodejjs。 与 软 链接 方式 不 同 ， 安 装 过 程 中 并 不 需要 指定 Nodejjs 的 具体 版 本 编号 ， 代 码 仓库 方 
式 总 是 以 最 新 版 本 的 Nodejjs 为 准 。 若 在 树 莓 派 3 代 中 安装 Node.js 可 参考 以 下 指令 : 


curl -sL https://deb.nodesource.com/setup 4.x | sudo -E bash - 
sudo apt-get install -y nodejs 


相对 于 以 上 两 种 方法 ， 源 代码 方式 安装 Node.js 需 要 消耗 较 多 时 间 ， 具 体 安装 过 程 如 下 : 


# 新 建 一 个 文件 夹 用 于 存放 Node .js 安装 文件 
mkdir -p software 


# 进入 software 目 录 


cd software 
wget https://nodejs.org/dist/v4.7.0/node-v4.7.0.tar.gz 
# 解压 Node .js 源 代 码 包 
tar -xzvf node-v4.7.0.tar.gz 

# 进入 Node.js 源 代码 文件 夹 

cd node-v4.7.0 

+ E 

./configu 
# 编译 源 文件 ， 编译 过 程 时 间 较 长 请 耐心 等 待 
make 
# 执行 安装 过 程 
sudo make install 


在 树 莓 派 3 中 新 建 一 个 控制 人 台 ， 在 控制 台中 依次 输入 “node-v” 和 “npm-v”， 通 过 检查 版 本 号 的 方式 判断 Node.js 是 否 成 功 安装 ， 此 时 树 莓 派 3 代 中 的 Nodejs 版 本 号 为 v4.7.0，npm 版 本 号 为 
2.15.11。 如 果 从 控制 台中 观察 到 正确 的 版 本 信息 ， 说 明 Nodejjs 已 经 安装 成 功 。 


node -v 
v4.7.0 
npm -v 
2.15.11 


2 node-coapA([ 不 例 


Node.js 具 有 良好 的 跨 平台 特性 ， 入 门 示例 涉及 的 client.js 和 server.js 均 可 在 Windows 主 机 、Linux PC 主机 或 是 树 莓 派 上 运行 。 与 其 他 的 几 个 示例 相似 ， 此 处 树 莓 派 依然 作为 CoAP 服 务 器 ， 而 Linux 主 机 
或 Windows 主 机 作为 CoAP 客 户 端 。CoAP 服 务 器 中 具有 一 个 系统 时 间 服 务 (资源 ) ， 通 过 该 服务 (资源 ) 可 获取 树 莓 派 的 系统 时 间 。Node-coap 入 门 示例 的 大 致 工作 流程 如 图 7-7 所 示 。 


node-coap 项 目的 更 多 内 容 可 参考 : /github.com/mcollina/node-coap., 


客户 端 client.js 服务 需 server.js 


GET /time 
一 一生 


2.03 Content 
EN a ey ny 1 


/NN 


Linux 或 Windows 


图 7-7 Node.js 入 门 示例 
1. 服 务 器 实现 
serverjs 实 现代 码 如 下 : 


代码 清单 7-5 serverjs 


coap = require ('coap') 
server = coap.createServer () 


Consi 
Consi 


server.on('request', function(req, res) { 
console.log (req.url) 
console.log (req.method) 

if (req.method == 'GET' && req.url.split('/')[1] == 'time') { 
res.end (new Date().toISOString()) 


} 
)) 


server.listen(function() ( 
console.log('server started') 


)) 


Serverjs 中 包含 一 个 time 路 由 ， 且 该 路 由 仪 支 持 GET 方 法 。 
(1) 创建 CoAP 服 务 并 侦 听 请 求 


通过 createServer 方 法 构造 一 个 CoAP Server， 并 通过 listen 方 法 侦 听 来 自 5683 端 口 的 CoAP 请 求 。 


const coap = require ('coap') 

const server = coap.createServer () 

server.listen(function() { 
console.log ('server started') 


)) 


(2) 处 理 CoAP 请 求 


若 CoAP 服 务 器 接收 到 来 自 CoAP 客 户 端的 请 求 ， 将 会 触发 request 消 息 ， 在 该 消息 回调 函数 中 对 请 求 内 容 变 量 req 进 行 处 理 。req.method=='GET'&&red.url.splt ('/) [1]=='time' 表 示 该 CoAP 仅 处 
HKHH “time” 的 请 求 ， 且 方法 必须 为 CoAP GET， 其 他 方法 或 路 由 该 CoAP 服 务 器 将 不 作 响应 。 


server.on('request', function(req, res) { 
console.log (req.url) 
console.log (req.method) 

if (req.method == 'GET' && req.url.split('/')[1] == 'time') { 
res.end (new Date().toISOString()) 


} 
)) 


(3) 返回 系统 时 间 


在 处 理 请 求 过 程 时 ，CoAP 服 务 器 通过 res.end (new Date () .tolSOString () ) 将 树 莓 派 的 系统 时 间 反 馈 至 客户 端 。 在 node-coap 框 架 中 response.end () 和 response.write () 均 可 向 CoAP 响 应 
中 填充 内 容 ，response.end () 包含 填充 与 执行 两 个 动作 ， 而 response.write () 仅 包 括 填 充 一 个 动作 。 换 名 话说，response.write () 填充 CoAP 响 应 之 后 还 应 调用 一 次 response.end () 。 


2. 客 户 端 实现 
client.js 实 现代 码 如 下 : 
代码 清单 7-6  client.js 


require ('coap') 
coap.request((host:'«raspberry ip address»', pathname:'time', method: 'GET']) 


const coap 
const req 


req.on('response', function (res) { 
console.log ('response code: ' + res.code) 
console.log ('response payload: ' + res.payloag)]) 


} 


(1) 创建 CoAP 请 求 


使 用 request 方 法 构造 CoAP 请 求 ， 在 request 参 数 中 写 入 一 个 JavaScript 对 象 ， 其 中 host 表 示 CoAP 服 务 器 |P 地 址 ， 此 处 需 使 用 树 莓 派 的 实际 IPv4 地 址 ; pathname 表 示 路 由 名 称 ， 此 处 为 “time”; 
method 表 CoAP 请 求 方法 ， 此 时 请 求 方法 为 “GET”。 


coap.request((host:'«raspberry ip address»', pathname:'time', method: 'GET']) 


(2) 响应 结果 输出 至 控制 台 


若 客户 端 接收 到 来 自 CoAP 服 务 器 的 正确 响应 ， 那 么 就 会 触发 response 事 件 ，res 变 量 中 保存 CoAP 响 应 的 全 部 内 容 ， 入 门 示例 代码 把 响应 码 res.code 和 响应 负载 res.payload 均 输出 至 控制 台中 。 


req.on('response', function (res) { 
console.log ('response code: ' + res.code) 
console.log ('response payload: ' + res.payload) 
}) 
3. 动 手 测试 


(1) 运行 CoAP 服 务 器 


运行 CoAP 服 务 器 之 前 需要 在 serverjs 同 级 目录 中 先 使 用 npm 工 具 安 装 node-coap，npm 是 一 种 Node.js 的 包 管理 工具 ， 通 过 npm install node-coap 可 完成 node-coap 的 安装 动作 ， 安 装 完成 之 后 ， 将 
在 serverjs 同 级 目录 中 增加 一 个 名 为 node_ modules 目 录 。 在 树 莓 派 控制 台中 输入 以 下 指令 以 启动 CoAP 服 务 器 : 


# 通过 npm 工 具 安 装 node-coap 
npm install node-coap 

+ 在 树 侮 派 3 中 启动 CoAP 服 务 器 
node server.js 

# 控制 台 输 出 


server started 


(2) 启动 CoAP 客 户 端 


在 Windows 或 者 Linux PC 主机 中 输入 以 下 指令 以 运行 CoAP 客 户 端 : 


# 通过 npm 安 装 node-coap 

npm install node-coap 

# 运行 coap 客 户 端 

node client.js 

# 控制 台 输出 

response code: 2.05 

response payload: 2016-08-01T08:14:32.00602Z2 


此 时 CoAP 响 应 码 为 2.05， 说 明 CoAP 服 务 器 成 功 处 理 了 CoAP 请 求 ，CoAP 响 应 负载 为 树 莓 派 的 系统 时 间 。 


7.4.3 node-coap 媒 体 类 型 示例 


node-coap 入 门 示例 中 server.js 仅 返回 文本 类 型 的 响应 负载 ， 无 法 根据 CoAP 客 户 端的 期 望 返回 不 同 媒体 类 型 的 响应 负载 。CoAP 规 定 ，CoAP 请 求 中 可 使 用 Accept 选 项 设置 期 望 媒体 类 型 ， 而 CoAP 响 
应 中 可 使 用 Content-Format 设 置 负载 媒体 类 型 。 在 本 小 节 的 示例 中 ，json_serverjs 将 通过 CoAP 请 求 中 的 Accept 选 项 返回 不 同 的 媒体 类 型 ，json_serverjs 的 工作 流程 如 图 7-8 所 示 。 


客户 六 HA 2s"mjson server.js 
PUT /multi-format 


*value" 
-> 


2.04 Changed 


“payload: value” 
一 


EN PUT /multi-format 


/ 722229. N Accept: application/json 


*value" 
——— A 


l 2.04 Changed 
Windowszk Linux * (*payload": *value"" 
AM ————  —É —Á SÉ ÁÁÓÁÁÉÁÉÁ—ÓÁ 4 


图 7-8 ”可 返回 JSON 响 应 示例 
1. 服 务 器 实现 
json_server.js 具 体 代码 如 下 : 


代码 清单 7-7 json server.js 


const coap = require ('coap') 
const server = coap.createServer () 


server.on('request', function (req, res) { 


console.log ('method:' + req.method + ' url:' + req.url) 
if (req.method == 'PUT' && req.url.split('/')[1] == 'multi-format') { 
if (req.headers['Accept'] == 'application/json') ( 
res.code = '2.04' 
res.setOption('Content-Format', 'application/json!) 


res.end(JSON.stringify(í(payload: req.payload.toString()])) 


) else ( 
res.code = '2.04' 
res.end('payload: ' + req.payload.toString()) 


} 
)) 


server.listen(function() ( 
console.log('server started') 


)) 


(1) 处 理 CoAP 请 求 


CoAP 服 务 器 仅 处 理 multi-format 路 由 ， 且 CoAP 请 求 的 方法 为 PUT。 


req.method == 'PUT' && req.url.split('/')[1] == 'multi-format' 


(2) 根据 请 求 首部 选项 返回 内 容 


如 果 请 求 首部 中 包含 Accept 选 项 ， 且 Accept 选 项 值 为 “application/json”， 那 么 CoAP 服 务 器 返回 JSJON 类 型 的 响应 内 容 ， 响 应 内 容 包括 一 个 JSJON 对 象 ， 该 JJON 对 象 中 的 键 名 为 “payload”， 键 值 
为 CoAP 请 求 负载 ， 如 果 请 求 首部 中 Accept 选 项 值 不 为 “application/json”，CoAP 服 务 器 返回 字符 串 类 型 的 响应 内 容 ， 响 应 内 容 在 “payload: ”之 后 增加 CoAP 请 求 中 的 负载 。 


if (req.headers['Accept'] == 'application/json') ( 
res.code = '2.04' 
res.setOption('Content-Format', 'application/json') 
res.end(JSON.stringify((payload: req.payload.toString()])) 
) else { 
res.code = '2.04' 
res.end('payload: ' + req.payload.toString()) 
} 
2. 动 手 测试 


(1) 运行 CoAP 服 务 器 


在 树 莓 派 中 新 建 控制 台 ， 在 控制 台中 输入 以 下 内 容 : 


# 运行 coap 服 务 器 
node json server.js 


(2) 运行 CoAP 客 户 端 


此 处 使 用 coap-client 工 具 作 为 CoAP 客 户 端 ， 在 Linux PC 控制 台中 输入 以 下 内 容 : 


coap-client -m put -A 50 -e value coap://192.168.0.6/multi-format 
: -m but 表 示 CoAP 请 求 方法 为 PUT 方法 。 
. -A 50 表 示 CoAP 请 求 中 包含 Accept 选 项 且 选 项 值 为 50，CoAP 媒 体 类 型 部 分 规定 50 即 代表 applicationV/json。 
: -evalue 表 示 CoAP 请 求 负载 为 “value”。 


若 CoAP 服 务 器 正确 处 理 客户 端 请 求 ，CoAP 服 务 器 将 返回 一 个 JSON 类 型 响应 。 


v:l t:CON c:PUT i:e7d9 {} [ ] 
("payload":"value"] 


若 去 除 coap-client 命 令 参 数 中 的 “-A 50" : 


coap-client -m put -e value coap://192.168.0.6/multi-format 


那么 CoAP 服 务 器 将 返回 字符 串 形 式 的 响应 负载 “payload: value" , 


v:l t:CON c:PUT i:42bO {} [ ] 
payload: value 


7.5 Californium 


Californium Eclipse loT 项 目的 一 部 分 ，Californium 可 简称 为 Cf。Californium 是 使 用 Java 语 言 实现 的 CoAP 开 源 框架 。Californium 包 含 CoAP 服 务 器 和 CoAP 客 户 端 方面 绝 大 多 数 RFC 文 档 所 描述 
的 特性 。 与 其 他 轻 量 级 的 开源 实现 不 同 ，Californium 还 包括 CoAP 安 全 部 分 DTLS。 相 比 于 Python、Node.js 等 新 一 代 计 算 机 编程 语言 ，Java 语 法 较为 沉重 、 学 习 周 期 也 长 ， 但 Java 在 Web 开 发 和 Android 开 
发 领域 却 占 有 举足轻重 的 地 位 。 本 书 前 文 提 及 的 coap: //wsncoap.org 测 试 服务 器 便 使 用 Cf 框架 开发 。 


Californium 是 本 章 中 较 难 掌 握 的 部 分 ， 该 部 分 需要 用 户 已 经 具备 Java 开 发 经 验 。 哩 然 这 些 部 分 看 似 复杂 ,但 是 只 要 参考 本 章 的 步骤 耐心 操作 也 可 以 正确 掌握 。 
使 用 Californium 之 前 需要 在 主机 中 正确 安装 JDK (Java Development Kit) 和 Java 集 成 开发 工具 。 在 本 节 入 门 示 例 中 ，Windows 主 机 内 已 经 正确 安装 JDK， 使 用 Eclipse 作 为 Java 集 成 开发 工具 。 


[1] https:/ /www.eclipse.org/californium/ o 


7.5.1 准备 工作 
与 之 前 入 门 示例 相似 ， 树 莓 派 3 代 依 然 作为 CoAP 服 务 器 ， 而 另 一 台 Windows 或 Linux 主 机 作为 CoAP 客 户 端 。 为 了 保证 入 门 示例 中 生成 的 可 执行 jar 文 件 可 在 树 莓 派 或 Windows 主 机 中 顺利 运行 ， 需 在 树 
莓 派 和 Windows 主 机 中 正确 安装 JDK。 由 于 树 莓 派 3 中 已 经 默认 安装 了 JDK， 而 多 数 Windows 主 机 可 参考 以 下 步骤 完成 JDK 的 安装 。 
1.Windows 主 机 下 JDK 安 装 
(1) 获取 JDK 安 装 文件 
前 往 Oracle 官 网 下 载 最 新 版 本 的 JDK 安 装 文件 ， 并 安装 到 Windows 主 机 中 ， 本 节 JDK 的 安装 目录 为 “D: \Program Files\Java\jdk1.8.0 111" , 
(2) 进入 环境 变量 修改 界面 


为 了 正常 使 用 DK， 需 在 Windows 中 设置 环境 变量 。 在 桌面 右 击 “ 我 的 电脑 ”选择 属性 ， 进 入 “系统 属性 ”界面 ， 选 择 “高 级 ”选项 卡 再 点 击 “ 环 境 变 量 ”。 如 图 7-9 所 示 。 


zet 
计算 机 名 硬件 aR ” 系统 保护 ”远程 
委 进 行 大 和 多数 更 疏 ， 你 必须 作为 管理 员 和 登录 。 


性 能 
HEGE STe. 内存 使 用 ,以太 诬 拟 内 存 


用 户 配 置 文件 
与 登录 帐户 相关 的 桌面 设置 


取消 应 用 (A) 


图 7-9 ”系统 属性 界面 
(3) 增加 JAVA_HOME 变 量 
在 系统 变量 中 增加 JAVA_HOME 变 量 ， 在 变量 值 中 写 入 JDK 具 体 安 装 路 径 ， 例 如 JDK 的 安装 路 径 为 “D: \Program FilesNWavaNdk1.8.0 131”。 如 图 7-10 所 示 。 


(4) 增加 CLASSPATH 变 量 


在 系统 变量 中 再 增加 一 个 CLASSPATH 变 量 ， 在 变量 值 中 增加 lib 目 录 和 toolsjar 文 件 ， 此 处 的 变量 值 为 “.; %JAVA_HOME%Nlib; %JAVA_HOME%\lib\toolsjar”。 如 图 7-11 所 示 。 


X 


JAVA HOME 


: 


图 7-10 ”增加 JAVA_HOME 系 统 变 量 


图 7-11 增加 CLASSPATH 系 统 变 量 


(5) 修改 PATH 变量 
最 后 修改 PATH 变量 。 在 PATH 变量 中 通过 “新 建 ”方法 增加 两 项 ， 一 项 为 “%JAVA_HOME9%N\bin” ， 另 一 项 为 “%JAVA_HOME%Ajrexbin”， 如 图 7-12 所 示 。 


图 7-12 ”修改 PATH 变量 


(6) JDK 安 装 验证 


为 了 验证 JDK 是 否 正确 安装 ， 可 在 Windows 控 制 人 台中 输入 “java-version” ， 若 安装 正确 可 获得 如 图 7-13 所 示 结 果 。 


EN CAWindowsXSystem32Xcmd.exe 


:WindowsMsystem32» java -version 
java version '1.8.0 131" 
Java(IM) SE Runtime Environment (build 1.8.0 131-b11) 


Java HotSpot(IM) 64-Bit Server VM (build 25.131-bll, mixed mode) 


: Windows \system32> 


图 7-13 ”验证 JDK 安 装 是 否 正确 
2. 树 莓 派 中 验证 JDK 安 装 


对 于 树 莓 派 3 代 来 说 JDK 已 经 默认 安装 软件 ， 在 树 莓 派 3 控制 台中 运行 “java-version” 也 可 以 查询 此 时 树 莓 派 3 中 的 JDK 版 本 编号 。 树 莓 派 3 代 控制 台 的 输出 结果 如 下 : 


java -version 

java version "1.8.0 65" 

Java (TM) SE Runtime Environment (build 1.8.0 65-b17) 
Java HotSpot (TM) Client VM (build 25.65-b01, mixed mode) 


7.5.2 ”Californium 入 门 示例 


Californium 入 门 示例 中 将 会 包括 两 台 设 备 ， 其 中 树 莓 派 3 作 为 CoAP 服 务 器 ， 该 服务 器 提供 一 个 hello 资 源 和 一 个 time 资 源 ， 而 另 一 台 Windows 或 Linux 主 机 作为 CoAP 客 户 端 。Californium 入 门 示 侈 的 
大 致 工作 流程 如 图 7-14 所 示 。 


2€ P iitest-coap-client.jar IH y ds ymtest-coap-server.jar 


GET /time 
— Yp 


2.05 Content 


“2016-12-12 21:34:52” 
aie S 


ME GET /hello 
a -en 
2.05 Content 


“Hello CoAP!" 
一 


Linux 或 Windows 


图 7-14 ”Californium 入门 示 例 
下 面 说 明 如 何 使 用 Eclipse 生成 CoAP 服 务 器 和 CoAP 客 户 端 可 执行 程序 。 
1. 使 用 Eclipse 创建 Java 工 程 
Eclipse 中 所 有 的 代码 都 需要 以 项 目 形 式 保 存 ， 项 目 可 以 理解 为 源 代码 、 外 部 程序 库 和 配置 文件 的 一 个 集合 。 下 面 就 使 用 Eclipse 创建 一 个 test-coap-server 工 程 。 


1) 打开 Eclipse， 在 菜单 栏 中 依次 选择 File 一 New 一 Project， 在 New Project 对 话 框 中 选择 “Java Project" ， 单 击 Next 按 钮 进入 下 一 步 。New Project 对 话 框 如 图 7-15 所 示 。 


e. New Project 


Select a wizard 


Create a Java project 


Wizards: 


type filter text 


(JS Java Project 

Æ Java Project from Existing Ant Buildfile 
GÈ Plug-in Project 

E General 

局 Eclipse Modeling Framework 

E EJB 

(— Java 

(— Java EE 

EE JavaScript 

E JAXB 


Finish 


图 7-15 ”新 建 Java 工 程 
2) 单 击 “Finish” 按 钮 之 后 进入 创建 项 目 对 话 杠 。 在 Project name 输 入 框 中 输入 项 目 名 称 “test-coap-server”， 其 他 设置 保持 默认 值 即 可 。 创 建 项 目 对 话 框 如 图 7-16 所 示 。 


3) 完成 工程 创建 之 后 再 新 建 一 个 类 文件 。 在 菜单 栏 中 依次 选择 “File 一 New 一 Class” 进 入 新 建 类 向 导 对 话 框 。 在 该 对 话 框 中 ， 包 名 Package 输 入 框 内 输入 “org.wsncoap”; 类 名 Name 输 入 框 内 输 
入 “HelloCoAPServer”， 此 时 Eclipse 中 将 创建 一 个 名 为 HelloCoAP- Serverjava 的 文件 。 新 建 类 向 导 对 话 框 如 图 7-17 所 示 。 


2. 获 取 Cf 相 关 JAR 文 件 


若 需 要 在 HelloCoAPServer 类 中 正确 实现 CoAP 服 务 器 ， 还 需要 在 工程 中 引入 Cf 框 染 相关 的 外 部 程序 扩展 库 。Cf 框 架 相关 的 外 部 程序 扩展 库 包 括 californium-core.jar、element-connector.jar 和 
scandium.jar。 其 中 : 


i. New Java Project 


Create a Java Project 


Create a Java project in the workspace or in an external location. 


Project name: test-coa p-server 


Use default location 
Location: Acf demoMe Browse... 
JRE 
(8) Use an execution environment JRE: 
©) Use a project specific JRE: jre1.8.0 111 E - 


©) Use default JRE (currently 'jre1.8.0 1117) Configure JREs... 


Project layout 

© Use project folder as root for sources and class files 

(€) Create separate folders for sources and class files Configure default... 
Working sets 


[ | Add project to working sets 


图 7-16 ”创建 test-coap-servet 工 程 


@ New Java Class 


Java Class 


Create a new Java class. 


Source folder: test-coap-server/src 


[ | Enclosing type: | Browse... 


HelloCoAPServer 


Modifiers: @ public (O package private protected 
| labstract | |final static 


Superclass: java.lang.Object 


Interfaces: 


Remove 


Which method stubs would you like to create? 
[ ] public static void main(String[] args) 
[ ] Constructors from superclass 
[7] Inherited abstract methods 
Do you want to add comments? (Configure templates and default value here) 


[ ] Generate comments 


图 7-17  88:EHelloCoAPServer X 
1) californium-core.jar 包 括 CoAP 核 心 部 分 。 
2) element-connectorjar 包 括 适 用 于 UDP 和 DTLS 的 Java 套 接 字 抽象 层 。 
3) scandiumJjar 包 括 DTLS 部 分 功能 。 
相关 Jar 文 件 可 前 往 Maven 中 央 仓 库 获 取 ，californium-core.jar、element-connector.jar 和 scandium.jar 的 maven 仓 库 网 址 如 下 : 
1) californium-core.jar: 
http://central.maven.org/maven2/org/eclipse/californium/californium-core/ 
2) element-connector jar: 


http://central.maven.org/maven2/org/eclipse/californium/element-connector/ 


3) scandium,jar: 
http://central.maven.org/maven2/org/eclipse/californium/scandium/ 


本 节 示 例 代 码 以 2.0.0-M2 版 本 jar 文 件 为 准 ， 在 test-coap-server 工 程 中 新 建 一 个 名 为 lib 的 文件 夹 ， 并 把 californium-core-2.0.0-M2.jar 和 element-connector-2.0.0-M2.jar 存 入 lib 文 件 夹 中 。 在 
Eclipse 1DE 中 同时 选中 californium-core-2.0.0-M2.jar 和 element-connector-2.0.0-M2Jar， 右 击 进 入 快捷 菜单 依次 选择 Build Path 一 Add to Build Path。 这 样 便 把 element-connector-2.0.0-M2.jar 和 和 
element-connector-2.0.0-M2jjar 加 入 到 工程 中 ， 有 具体 过 程 如 图 7-18 所 示 。 
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图 7-18 ”增加 外 部 程序 扩展 库 
3.HelloCoAPServer.java 
在 HelloCoAPServer.java 中 增加 一 个 main 函 数 ， 在 main 函 数 中 增加 两 个 CoAP 资 源 : 一 个 名 为 “hello”， 另 一 个 名 为 “time”。 HelloCoAPServer.java 的 具体 内 容 如 下 : 


代码 清单 7-8 HelloCoAPServer.java 


package org.wsncoap; 
import java.text.SimpleDateFormat; 
import java.util.Date; 


import org.eclipse.californium.core.CoapResource; 

import org.eclipse.californium.core.CoapServer; 

import org.eclipse.californium.core.coap.CoAP.ResponseCode; 

import org.eclipse.californium.core.server.resources.CoapExchange; 


public class HelloCoAPServer { 
public static void main(String[] args) { 
CoapServer server - new CoapServer(); 
server.add(new CoapResource ("hello") 
QOverride 
public void handleGET (CoapExchange exchange) { 
exchange.respond (ResponseCode.CONTENT, "Hello CoAP!"); 


{ 


) 
); 
server.add(new CoapResource ("time") ( 
GOverride 
public void handleGET (CoapExchange exchange) { 
Date date - new Date(); 
exchange.respond (ResponseCode .CONTENT, 
new SimpleDateFormat ("yyyy-MM-dd HH:mm:ss").format (date)); 


) 
]):; 


server.start(); 


HelloCoAPServer.java 简 要 说 明 如 下 : 

(1) 创建 CoAP 服 务 器 

CoapServer server=new CoapServer () 构建 CoAP 服 务 器 对 象 server， 构 建 完成 之 后 便 可 向 server 实 例 中 增加 CoAP 资 源 。 
(2) 增加 hello 资 源 


通过 CoapServer 类 中 add 方 法 在 server 实 例 中 增加 资源 ， 此 外 通过 匿名 方法 构造 一 个 名 为 “hello” 的 CoAP 资 源 ， 在 该 CoAP 资 源 中 重 写 handleGET 方 法 。 若 CoAP 服 务 器 接收 到 URI 为 hello 的 CoAP 
GET 请 求 ， 那 么 将 通过 handleGET 函 数 返 回 字 符 串 形式 的 “Hello CoAP! ”。 


server.add(new CoapResource ("hello") { 

GOverride 
public void handleGET (CoapExchange exchange) { 

exchange.respond (ResponseCode.CONTENT, "Hello CoAP!"); 


) 
F? 


(3) 增加 time 资 源 


CoAP 服 务 器 除了 hello 资 源 之 外 还 包括 time 资 源 。 与 hello 资 源 不 同 ，time 资 源 返 回 “ 年 -月 -日 时 : 分 : Eb" 这样 固 定格 式 的 字符 串 内 容 。 


server.add(new CoapResource ("time") ( 
GOverride 
public void handleGET (CoapExchange exchange) { 
Date date - new Date(); 
exchange.respond (ResponseCode.CONTENT, 
new SimpleDateFormat ("yyyy-MM-dd HH:mm:ss").format (date)); 


} 
]):; 


(4) 启动 CoAP 服 务 器 
最 后 使 用 start 方 法 启动 CoAP 服 务 器 。 


4.GETClient.java 


完成 CoAP 服 务 器 代码 编写 之 后 我 们 再 进行 CoAP 客 户 端 代码 的 编写 。 在 Eclipse 中 新 建 一 个 名 为 test-coap-client 工 程 ， 通 过 类 创建 向 导 新 建 一 个 名 为 GETClientjava 的 源 文件 ，GETClientjava 的 具体 代 
码 如 下 。 


代码 清单 7-9 GETClient.java 


package org.wsncoap; 


.URI; 


import ; 
.URISyntaxException; 


impor 


java.ne 
java.ne 


ct ct 


ct cT 


import org.eclipse.californium.core.CoapClient; 
import org.eclipse.californium.core.CoapResponse; 
import org.eclipse.californium.core.Utils; 


m 


Eis 


public class GETClient { 

public static void main (String args[]) { 
URI uri = null; 

if (args.length > 0) ( 


try { 
uri = new URI (args[0]); 

} catch (URISyntaxException e) { 
System.err.println("Invalid URI: " + e.getMessage()); 


System.exit (-1); 


CoapClient client = new CoapClient (uri); 
CoapResponse response - client.get(); 
if (response!-null) ( 


System.out.println (response.getCode()); 
System.out.println (response.getOptions ()); 
System.out.println (response.getResponseText ()); 


System.out.printiln ("NnADVANCEDNn"); 

System.out.println(Utils.prettyPrint (response)); 
) else { 

System.out.println("No response received."); 


) 


GETClient.java 简 要 说 明 如 下 : 

(1) 获取 CoAP URI 

uri=new URI (args[0]) : GETClient.java 通 过 命令 行 的 第 一 个 参数 获取 CoAP URI, 
(2) 构造 并 发 送 CoAP 请 求 


构造 一 个 CoAP 请 求 对 象 ， 通 过 CoapClient 类 中 的 GET 方 法 发 送 CoAP 请 求 。 


CoapClient client = new CoapClient (uri); 
CoapResponse response - client.get(); 


(3) 获取 响应 并 输出 至 控制 台 
若 CoAP 客 户 端 接收 到 来 自 CoAP 服 务 器 的 响应 ， 那 么 GETClientjava 将 把 响应 码 、 响 应 选项 和 响应 负载 输出 至 控制 台 。 其 中 : 
. response.getCode () 可 获取 响应 码 。 
: response.getOptions () 可 获取 响应 选项 。 
- tesponse.getResponseText () 可 获取 字符 串 形式 的 响应 负载 。 


Cf 框架 中 也 可 以 使 用 Utils.prettyPrint 方 法 ， 把 response 变 量 格式 化 之 后 输出 至 控制 台 ， 通 过 Utils.prettyPrint 方 法 格式 化 之 后 内 容 更 容易 被 阅读 。 


System.out.println (response.getCode()); 
System.out.println (response.getOptions ()); 
System.out.println (response.getResponseText ()); 


System.out.println ("NnADVANCEDNn"); 
System.out.println(Utils.prettyPrint (response)); 


5. 动 手 测试 

完成 CoAP 服 务 器 和 CoAP 客 户 端的 代码 编写 工作 之 后 可 进入 动手 测试 环节 。 

(1) 生成 可 执行 jar 文 件 

为 了 脱离 Eclipse 集成 开发 环境 ， 可 借助 Export 工 具 导 出 可 运行 jar 文 件 ， 以 test-coap-server 工 程 为 例 说 明 如 何 生成 可 执行 的 jar 文 件 。 
1) 选中 test-coap-server 工 程 ， 右 击 进 入 快捷 菜单 。 

2) 在 快捷 菜单 中 选择 Export， 进 入 Export 对 话 框 。 


3) 在 Export 对 话 框 中 选择 Runnable JAR file， 单 击 Next 按 钮 进入 下 一 步 。Export 对 话 框 如 图 7-19 所 示 。 


4) 在 Runnable JAR file 对 话 框 中 选择 test-coap-server 工 程 ， 并 选择 合适 的 输出 路 径 ， 最 后 单 击 Finish 按 钮 完成 所 有 的 输出 操作 ， 该 步骤 操作 过 程 如 图 7-20 所 示 。 


© Export 
Select 


Export all resources required to run an application into a JAR file on the 
local file system. 


Select an export destination: 


(2. General 
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E Install 
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D JAR file 


@) Javadoc 
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(— Java EE 
E Plug-in Development 
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图 7-19 ”EExport 对 话 框 


'® Runnable JAR File Export 


Runnable JAR File Specification 


Select a Java Application' launch configuration to use to create a runnable 
JAR. 


Launch configuration: 


HelloCoAPServer - test-coap-server 


Export destination: 
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Library handling: 

(8) Extract required libraries into generated JAR 

(O Package required libraries into generated JAR 

(C) Copy required libraries into a sub-folder next to the generated JAR 


[ |Save as ANT script 


ANT script location: |\the beginning of coap\simple demoXcf demo 


图 7-20 ”输出 可 执行 JAR 文 件 
(2) 运行 CoAP 服 务 器 


通过 上 面 的 步骤 可 以 获得 两 个 可 执行 JAR 文 件 一 一 test-coap-serverjar 和 test-coap-clientjar。 为 了 在 树 莓 派 中 运行 CoAP 服 务 器 可 使 用 ?FTP 工 具 把 test-coap-serverjar 传 输 至 树 莓 派 3 代 中 。 在 树 莓 派 
中 新 建 控制 台 并 在 控制 台中 输入 以 下 内 容 : 


# 运行 CoAP 服 务 器 
java -jar test-coap-server.jar 


(3) 运行 CoAP 客 户 端 


在 Windows 主 机 中 新 建 一 个 控制 台 ， 在 控制 台中 运行 test-coap-client.jar。 与 CoAP 服 务 器 不 同 ，test-coap-client.jar 运 行 时 需要 一 个 URI 参 数 。 在 Cf 入 门 示例 中 树 莓 派 3 的 IPv4 地 址 为 192.168.0.6， 那 
么 树 莓 派 3 中 hello 资 源 和 time 资 源 的 URI 分 别 为 : 


.hello 资源 : coap: //192.168.0.6/hello。 
: timet 7&: coap: //192.168.0.6/time。 


若 访问 hello 资 源 可 在 控制 台中 输入 以 下 指令 : 


java -jar test-coap-client.jar coap://192.168.0.6/hello 


若 CoAP 服 务 器 正确 处 理 请 求 ，Windows 控 制 台 将 获得 以 下 内 容 : 


2.05 
("Content-Format":"text/plain") 


Hello CoAP! 


ADVANCED 


==[ CoAP Response | 
MID : 32637 
Token : 75a4bb0bac805d84 

Type : ACK 

Status : 2.05 

Options: ("Content-Format":"text/plain") 
oad: 11 Bytes 


若 访问 time 资 源 ， 可 在 Windows 控 制 台 中 输入 以 下 指令 : 


java -jar test-coap-client.jar coap://192.168.0.6/time 


若 CoAP 服 务 器 正确 处 理 请 求 ，Windows 控 制 台 将 输出 以 下 内 容 : 


2.05 
("Content-Format":"text/plain") 
2016-12-19 20:05:36 


ADVANCED 


==[ CoAP Response | 
MID : 30807 
Token : ae6ad1b628 
Type : ACK 

Status : 2.05 
Options: ("Content-Format":"text/plain") 
Payload: 19 Bytes 


2016-12-19 20:05:36 


7.6 ”本 章 小 结 


本 章 总 共 介 绍 了 4 种 不 同 的 CoAP 实 现 框架 ， 这 4 种 框架 分 别 是 C 语 言 实现 的 libcoap、Java 语 言 实现 的 Californium、Python 语 言 实现 的 aiocoap 和 Node.js 语 言 实 现 的 node-coap。Java 语 言 实现 的 Californium 功 能 最 
完整 ， 但 上 手 较为 困难 ; 而 Python 语言 实现 的 aiocoap 和 Node.js 语 言 实 现 的 node-coap， 学 习 和 使 用 的 过 程 相 对 简单 ， 实 现 同样 的 功能 Python 和 Node.js 的 代码 也 显得 更 为 简洁 。 对 于 libcoap ， 本 章 仅 介绍 如 何 使 用 


libcoap 提 供 的 可 执行 文件 ， 若 使 用 libcoap 提 供 的 API， 需 要 自行 编写 Makefile 文 件 ， 从 某 种 角度 来 说 ，libcoap 的 使 用 和 学 习 难 度 相 较 于 Java、Python 和 Node.js 更 大 。 


虽然 各 种 CoAP 框 架 存在 明显 区 别 ， 但 是 并 不 能 简单 地 说 在 CoAP 应 用 领域 Node.js 优 于 Python 3, Python 3 优 于 Java，Java 优 于 C。 每 种 计算 机 语言 、 每 种 CoAP 框 架 都 有 自身 的 特点 和 使 用 场景 。Node.js 网 络 
功能 强大 ， 通 过 回调 的 方式 使 代码 显得 异常 简洁 ; Python 2 或 者 Python 3 作为 树 苦 派 中 的 默认 开发 语言 ， 有 大 量 的 操作 硬件 的 示例 ， 若 Python aicoap 框 架 结 合 树 苦 派 以 及 外 围 硬件 ， 可 以 制作 出 五 花 入 门 的 硬件 
应 用 ; 而 Java Californium 虽然 稍 显 复杂 ， 但 可 以 融入 到 Android 开 发 中 ， 那 么 使 用 手机 也 可 以 通过 CoAP 控 制 硬 件 设 备 ， 这 也 留 给 用 户 很 大 的 想象 空间 ; C 语 言 在 谱 入 式 领域 中 占有 不 可 忽视 的 地 位 ， 多 数 座 入 
式 设备 仍 不 具备 运行 Java、Python 和 Node.js 的 能 力 ， 那 么 C 语 言 在 嵌入 式 设 备 的 CoAP 开 发 中 也 会 获得 广泛 的 应 用 。 


第 8 章 ”CoAP 调 试 工 具 


8.1 ”本章 主 要 内 容 


本 章 将 重点 学 习 CoAP 的 调试 技巧 。 在 HTTP 应 用 开发 过 程 中 包含 很 多 调试 工具 和 调试 技巧 ， 这 些 调试 工具 可 以 帮助 用 户 发 送 合适 的 HTTP 请 求 ， 通 过 这 些 工 具 也 可 以 修改 HTTP 请 求 首部 和 请 求 负载 ， 以 
及 验证 服务 器 是 否 正常 工作 。 例 如 ， 使 用 Firefox 浏 览 器 中 的 扩展 插件 Httprequester 模 拟 发送 HTTP 请 求 ;使 用 Wireshark 分 析 HTTP 请 求 和 HTTP 响 应 ; 使 用 cURL 客户 端 工具 模拟 发 送 HTTP 请 求 等 。 在 CoAP 
服务 的 开发 过 程 中 也 有 这 种 类 型 的 辅助 工具 ， 通 过 这 些 辅 助 工 具 不 但 可 以 验证 CoAP 协 议 的 各 种 细节 ， 还 可 以 帮助 用 户 加 速 完 成 CoAP 服 务 器 和 CoAP 客 户 端的 开发 工作 。 


本 章 中 我 们 将 重点 学 习 两 种 调试 工具 一 一 Firefox 中 的 Copper 插 件 和 Wireshark。Copper 插 件 是 一 款 CoAP 客 户 端 专用 插件 ;Wireshark 是 常用 的 网 络 抓 包工 具 ， 通 过 该 工具 不 但 可 以 展现 CoAP 的 所 有 
细节 ， 还 可 以 了 解 CoAP 与 其 他 TCP/IP 族 协议 之 间 的 关系。 


第 8 章 ”CoAP 调 试 工 具 


8.1 ”本章 主 要 内 容 


本 章 将 重点 学 习 CoAP 的 调试 技巧 。 在 HTTP 应 用 开发 过 程 中 包含 很 多 调试 工具 和 调试 技巧 ， 这 些 调试 工具 可 以 帮助 用 户 发 送 合适 的 HTTP 请 求 ， 通 过 这 些 工 具 也 可 以 修改 HTTP 请 求 首部 和 请 求 负载 ， 以 
及 验证 服务 器 是 否 正常 工作 。 例 如 ， 使 用 Firefox 浏 览 器 中 的 扩展 插件 Httprequester 模 拟 发 送 HTTP 请 求 ;使 用 Wireshark 分 析 HTTP 请 求 和 HTTP 响 应 ; 使 用 cURL 客户 端 工 具 模 拟 发 送 HTTP 请 求 等 。 在 CoAP 
服务 的 开发 过 程 中 也 有 这 种 类 型 的 辅助 工具 ， 通 过 这 些 辅 助 工 具 不 但 可 以 验证 CoAP 协 议 的 各 种 细节 ， 还 可 以 帮助 用 户 加 速 完 成 CoAP 服 务 器 和 CoAP 客 户 端的 开发 工作 。 


本 章 中 我 们 将 重点 学 习 两 种 调试 工具 一 一 Firefox 中 的 Copper 插 件 和 Wireshark。Copper 揪 件 是 一 款 CoAP 客 户 端 专用 插件 ; Wireshark 是 常用 的 网 络 抓 包 工具 ， 通 过 该 工具 不 但 可 以 展现 CoAP 的 所 有 
细节 ， 还 可 以 了 解 CoAP 与 其 他 TCP/IP 族 协议 之 间 的 关系 。 


8.2 Copper LE 


Copper 是 一 款 非 常 容易 上 手 的 CoAP 客 户 端 调试 工具 ， 在 前 面 多 个 章节 中 已 经 介绍 并 使 用 了 该 插件 ， 本 节 我 们 将 更 深入 地 了 解 Copper 插 件 的 使 用 细节 。 


Copper 揪 件 是 一 款 客户 端 调试 工具 ， 在 没有 CoAP 服 务 器 的 情况 下 单独 使 用 CoAP 客 户 端 是 没有 任何 意义 的 。 若 借助 Copper 插 件 进行 CoAP 实 验 可 使 用 本 书 提供 的 CoAP 测 试 服务 器 ， 该 CoAP 测 试 服务 
器 的 域名 为 coap: //wsncoap.org; 也 可 以 使 用 Eclipse 项 目 提供 的 CoAP 测 试 服务 器 ， 该 测试 服务 器 的 域名 为 coap: /californium.eclipse.org/。 本 节 并 不 推荐 “生硬 ”地 学 习 Copper 插 件 ， 而 应 结合 
书 第 5 和 6 章 ， 通 过 Copper 实 验 的 方式 深入 理解 CoAP 的 细节 。 在 Firefox 浏 览 器 中 安装 Copper 的 具体 步骤 可 参考 4.2 节 。 若 正确 安装 了 Copper 揪 件 ， 可 以 在 Firefox 浏 览 器 地 址 栏 中 输 
入 “coap: //wsncoap.org”， 按 回 车 键 之 后 可 观察 到 如 图 8-1 所 示 的 相似 界面 。 
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图 8-1 Copper 调 试 工具 


Copper 调 试 工具 大 致 可 以 分 为 以 下 几 个 部 分 : 地 址 栏 、 工 具 栏 、 响 应 消息 简要 提示 、 响 应 消息 首部 面板 、 请 求 或 响应 内 容 面板 、 路 由 面板 、 请 求 选 项 设置 面板 。 


8.2.1 Copper 地 址 栏 


Copper 揪 件 与 Firefox 浏 览 器 共用 地 址 栏 ，Copper 地 址 栏 中 的 服务 器 地 址 必须 以 “coap: //” 开 头 ，Copper 揪 件 地 址 栏 的 使 用 方法 如 图 8-2 所 示 。 


€ © coap://wsncoap.org:5683/path/sub1 


地 址 必须 以 coap 开 头 


图 8-2 ”Coppet 地 址 栏 
Copper 地 址 栏 可 以 设置 CoAP 请 求 中 的 很 多 内 容 ， 这 些 内 容 包 括 : 
- CoAP 服 务 器 域名 或 IP 地 址 : 例如 此 处 服务 器 域名 为 wsncoap.org， 该 服务 器 的 全 网 IP 地 址 为 139.196.187.107， 在 地 址 栏 中 填 入 coap: //wsncoap.org 与 coap: //139.196.187.107 的 效果 几乎 相同 。 
: CoAP 服 务 器 端口 号 : 例如 此 处 CoAP 应 用 端口 号 为 5683。 
- CoAP 资 源 路 由 名 称 : 例如 coap: //wsncoap.org: 5683/segl/seg2/seg3， 其 中 seg1/seg2/seg3 将 填 入 CoAP 请 求 首 部 的 相关 区 域 中 。 


: CoAP 资 源 查询 条 件 : 例如 coap: //wsncoap.org: 5683/query?limit=10&offset=20， 该 地 址 包含 两 个 有 效 查询 条 件 一 一 “limit=10” 和 “offset=20”， 这 两 个 查询 条 件 也 会 填 入 CoAP 请 求 首部 的 相关 区 域 


Copper 揪 件 只 能 识别 以 “coap: //” 开 头 的 合法 CoAP URI， 以 下 几 个 示例 地 址 均 为 合法 的 CoAP URI: 


: coap: //wsncoap.org: 5683/.well-known/core 
< coap: //wsncoap.org: 5683/test 
: coap: //wsncoap.org: 5683/segl /seg2/seg3 


: coap: //wsncoap.org: 5683/query?limit- 10&offset-20 


8.2.2 Copper 工具 栏 


copper 工具 栏 如 图 8-3 所 示 。 


©) Ping Q Discover e GET > POST cJ PUT x DELETE Observe | Payload ~ Behavior - 


Oooo 


Ping 检查 主机 是 否 存 在 设置 CoAP 请 求 方法 
Discover 访问 主机 /.well-known/core 


图 8-3 ”Coopet 工 具 栏 
Copper 工 具 栏 包含 以 下 主要 功能 : 
1) Ping 工 具 用 于 测试 服务 器 中 的 CoAP 服 务 是 否 正常 启用 。 该 Ping 工 具 并 不 向 主机 发 送 ICMP 请 求 ， 而 是 向 服务 器 发 送 一 个 空 CoAP 请 求 。 
2) Discover 工 具 用 于 访问 CoAP 服 务 器 的 /.well-known/core 路 由 。 若 使 用 Discover 工 具 ，Copper 插 件 的 路 由 面板 区 域 将 会 立即 更 新 。 
3) GET、POST、PUT 和 DELETE 设 置 CoOAP 请 求 方法 。Copper 揪 件 支 持 CoOAP 中 规定 的 4 种 请 求 方法 。 
4) Observe 启 动 或 停止 观察 CoAP 服 务 器 中 的 某 个 资源 。 


5) Payload 设 置 CoAP 请 求 负载 的 设置 方式 ，Copper 揪 件 有 两 种 设置 请 求 负载 的 方法 一 一 文本 方法 和 文件 方法 。 默 认 选择 文本 方法 ， 选 择 文件 方法 时 需要 指定 文件 的 具体 路 径 。 


6) Behavior 设 置 Copper 其 他 常用 行为 ， 该 工具 包含 一 个 下 拉 菜单 ，Behavior 工 具 的 具体 选项 如 图 8-4 所 示 。Behavior 选 项 内 容 较 多 ， 大 致 包括 以 下 内 容 : 
. 选择 CoAP 请 求 类 型 : 默认 为 CON 请 求 ， 也 可 以 设置 为 NON 请 求 。 
. 设置 分 块 传输 大 小 : 在 CoAP 中 分 块 传输 大 小 可 以 设置 为 16、32、64、128、256、512 和 1024。 


. 设置 停止 观察 的 方法 : Copper 桂 件 中 可 以 选择 两 种 方法 一 一 通过 GET 方法 停止 观察 或 RST 类 型 请 求 停止 观察 。 
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RST Observe cancel 


图 8-4 Behaviot 选 项 设置 


8.2.3 Copper 虽 应 首部 

Copper 响 应 首部 可 以 简单 直观 地 反映 CoAP 响 应 首部 中 的 所 有 细节 。 若 使 用 GET 方 法 访问 coap: /wsncoap.org/validate 资 源 ， 可 获得 如 图 8-5 所 示 界 面 。Copper 插 件 一 般 通 过 三 个 区 域 反馈 CoAP 响 
应 首部 。 

1) 简要 信息 区 域 : 通过 加 大 字体 显示 CoAP 响 应 码 ， 如 “2.05 Content" $[] "4.04 NOT Found" 等 。 

2) CoAP 首 部 信息 区 域 : 该 区 域 主要 显示 CoAP 响 应 首部 中 的 四 个 固定 子 内 容 ， 如 报 文 类 型 、 响 应 码 、 报 文 编号 和 报 文 标签 。 


3) CoAP 选 项 信息 : 该 区 域 主要 显示 CoAP 选 项 部 分 ， 如 Etag 选 项 、Content-Format 媒 体 类 型 选项 、 分 块 传输 选项 等 内 容 。 与 CoAP 首 部 信息 区 域 不 同 ， 该 区 域 的 子 项 个 数 不 确 定 ， 不 同 的 CoAP 响 应 
所 包含 的 CoAP 选 项 数量 可 能 不 同 。 
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2.05 Content (Blockwise) (Download finished) © 


Header Value e Option Value 

Type ACK ETag OxFA7B 

Code 2.05 Content Content-Format text/plain 
MID 36121 Block2 0 (64 B/block) 
Token empty 


图 8-5 “Coppet 响 应 首部 


8.2.4 ”Copper 负 载 内 容 


Copper 负 载 内 容 区 域 主要 用 于 显示 CoAP 请 求 负载 和 CoAP 响 应 负载 ， 该 区 域 也 可 以 分 为 三 部 分 ， 可 通过 该 区 域 上 半 部 分 的 选项 卡 标签 进行 切换 。 若 使 用 GET 方 法 访问 coap: //wsncoap.org: 
5683/.well-known/core， 在 Copper 负 和 载 部 分 将 会 获得 如 图 8-6 所 示 界 面 。 
Combined Payload (2064) 
t Incoming 1.3 Rendered k Outgoing 
:obs:rt= OWServe ; title Observable resource which changes every 9 seconds”, C/obs- 


pumping?:obs;rt- observe :title= OÜbservable resource which changes every 5 seconds”, 
C/separate»;title- Resource which cannot be served immediately and which cannot be 


acknowledged in a pizgzy-backed way ,4/large-creste^;rt- block ;title- Large resource that 
can be created using POST method”, &/large-create/T5;ct-l;sz-4, C/large-create/8»;ct-l; 
sz-4, C/segl»?;title- Long path resource”, &/segl/seg2»;title- Long path resource", C/segl 
/seg2/seg3»;title-' Long path resource ,X/large-separate?;rt- block ;sz-1280;title-' Large 
resource ,4/obs-reset?, €£/. well-known/core?, &/multi-format?;ct- 0 41 ;title= Resource that 
exists in different content formats (text/plain utf8 and application/xml)”, &/path5;ct-40; 
title=" Hierarchical link description entrv',X/path/subl»5;title- Hierarchical link 


图 8-6 Copper 负载 部 分 


1) Incoming 显 示 CoAP 响 应 文本 内 容 ， 该 区 域 不 可 修改 。 


2) Rendered 显 示 经 过 泻 染 的 响应 内 容 ， 该 区 域 不 可 修改 。 该 区 域 把 CoAP 响 应 内 容 适 当 处 理 使 之 更 加 方便 阅读 与 分 析 。 在 图 8-6 中 CoAP 响 应 完全 以 文本 形式 展现 ， 该 部 分 甚至 没有 逐 行 显示 ， 所 有 的 
响应 负载 被 堆砌 在 一 个 文本 框 中。 在 图 8-7 中 响应 负载 经 过 泻 染 处 理 ， 响 应 内 容 使 用 更 加 直观 的 形式 展现 ， 大 大 简化 了 阅读 与 分 析 难 度 。Copper 插 件 能 够 泻 染 link-format 格 式 、XML 格 式 和 JSON 格 式 。 


Combined Payload (2064) 


E) Incoming EJ Rendered [3 Outgoing 


/obs 


m obs: true 
m rt: observe 


a title: Observable resource which changes every 5 seconds 


/obs-pumping 


m nhe- trie 


图 8-7 ”Coppet 播 件 泻 染 响应 负载 


3) Outgoing 显 示 CoAP 请 求 负载 ， 该 区 域 可 以 修改 ， 用 于 设置 用 户 自 定义 请 求 负载 。 


8.2.5 Copper 请 求 选项 

Copper 请 求 选 项 部 分 是 Copper 插 件 中 最 难 掌握 的 部 分 ， 其 具体 内 容 如 图 8-8 所 示 。 在 CoAP 请 求 中 增加 选项 内 容 前 需要 选中 复 选 框 “Debug Control” ， 否 则 所 有 的 请 求 选 项 均 为 失效 状态 。Copper 
插件 的 请 求 选项 较 多 ， 它 支持 的 请 求 选 项 包括 : 

: CoAP 请 求 标签 Token。 

CoAP 请 求 期 望 媒体 类 型 设置 Accept。 

. CoAP 请 求 媒体 类 型 设置 Content-Format。 

.CoAP 块 传输 选项 Block1、Block2、Size1 和 Size2。 

.CoAP 观 察 者 选项 Obsetrve。 

: CoAP 实 体 标记 Etag。 

. CoAP 条 件 请 求 选项 IEMatch 和 IfENone-Match。 


- CoAP Uri-Host 和 Uri-Port 等 。 


E^] Debug Control If- Match 
Token ^ 


ke] If-None-Match 
Uri-Host Uri-Port 


Request Options 
dis i 
use absolute URI X 


use hex (Ox..) or string 


Content-Format 
门 Use Proxy-Scheme option 
Block1 (Req.) Block2 (Res.) Auto Response Options 


block no. X 四] Max-Age 


Size] Size? use integer 


Location-Path — Location-Query 


| 


total size X 


人 


ETag Number Value 


total size X 


use hex (Ox) or string ! use hex (Ux.) or strX 


a) 请 求 选 项 上 半 部 分 b) 请 求 选 项 下 半 部 分 


注 
© = 在 Coppet 播 件 的 请 求 选 项 部 分 不 能 设置 Uri-Quetry 内 容 ， 若 在 CoAP 请 求 中 包含 Uri-Quety 内 容 ， 需 要 在 Coppet 播 件 的 地 址 栏 中 写 入 Quety 参 数 ， 如 coap: //wsncoap.org: 5683/query? 


limit=108offset=20。 


8.2.6 ”Copper 使 用 示例 


为 了 测试 Copper 插 件 ， 首 先 需 要 搭建 一 个 CoAP 服 务 器 。 本 书 之 前 的 章节 已 经 介绍 过 多 种 搭建 CoAP 服 务 器 的 方法 ， 如 使 用 Python 3 的 aiocoap 框 架 、 使 用 Node.js 的 node-coap 框 架 和 使 用 Java 的 
Californium 框 架 。 为 了 更 方便 地 讨论 Copper 插 件 的 使 用 方法 ， 本 章 将 使 用 coap: /wsncoap.org 提 供 的 CoAP 测 试 服务 器 。CoAP 测 试 服务 器 提供 了 多 种 用 于 测试 目的 的 CoAP 资 源 ， 通 过 这 些 CoAP 资 源 
用 户 可 以 了 解 CoAP 的 诸多 细节 ， 如 CoAP 分 离 模式 、Etag 选 项 和 CoAP 观 察 者 模式 等 。 


下 面 通 过 三 个 从 简 到 难 的 示例 说 明 如 何 使 用 Copper 插 件 ，Copper 揪 件 的 使 用 难点 在 于 熟练 使 用 CoAP 选 项 。 
1.GET With Query 

第 一 个 示例 将 说 明 如 何 使 用 CoAP Uri-Query 选 项 ，Uri-Query 示 例 的 具体 过 程 如 图 8-9 所 示 。 

1) 在 Copper 的 地 址 栏 中 输入 coap: //wsncoap.org: 5683/query?limit=10&offset=20。 

2) 单 击 工具 栏 中 的 GET 按 钮 ， 发 送 CoAP 请 求 。 


3) 若 服务 器 正确 返回 ， 可 以 在 负载 内 容 部 分 的 响应 文本 区 域 获得 “?limit=10&offset=20”。 在 CoAP 服 务 器 中 ， 两 个 Uri-Query 选 项 limit=10 和 offset= 20 被 重新 组 合 ， 并 还 原 为 “? 
limit=10&offset=20” 返 回 至 CoAP 客 户 端 。 


再 次 强调 ， 在 Copper 揪 件 中 ，Uri-Query 选 项 应 在 Copper 插 件 的 地 址 栏 中 体现 ， 在 Copper 插 件 右 侧 的 请 求 选项 中 不 能 设置 该 参数 。 


[x1] wsncoap.org:5683 


«€ © coap;//wsncoap.org:5683/query?limt- 10&offset- 20 g) Ug c QQ Bing <Ctri+K> 
Ping (3 Discover | J cer L3 rost E3 pur £3 DeLETE Observe | Payload - Behavior - 
[7] Debug Control 


2 
2.05 Content (Blockwise) (Download finished) il . 
Header Value Option Value 


Type ACK Content-Format text/plain Request Options 
Code 2.05 Content Block2 0 (64 B/block) Accept 


MD 49020 | 


Token empty :| Content-Format 


payload 57 leuis ë 


© Incoming Ç} Rendered  1;j Outgoing Block (Req.) Block2 (Res.) Auto 


mee oo | 2 


Code: 1 (GET) Size1 Size2 


uc | total size x| | tota! size x| 
z total x| | total size X 
91imt=10&offset=20 9 otal size otal size 


Observe 


图 8-9  Copperd& fFUri-Query 3 zii 4& H] 
2.GET/validate With Etag 


相 比 于 上 一 个 示例 ， 通 过 Etag 选 项 访问 validate 资 源 要 复杂 得 多 。 在 该 示例 中 首先 通过 GET 方 法 获取 validate 资 源 ， 获 取 资 源 的 同时 记录 Etag; 接着 使 用 GET 方 法 重新 访问 validate 资 源 ， 在 请 求 首部 中 
填 入 Etag， 由 于 请 求 首部 的 Etag 和 服务 器 中 validate 的 Etag 完 全 相同 ， 服 务 器 不 会 重复 返回 资源 ， 而 是 通过 2.03 Valid 告知 客户 端 资 源 并 没有 改变 ， 可 使 用 上 一 次 的 缓存 ; 然后 CoAP 客 户 端 通过 PUT 方法 强 
制 改 变 资源 ; 由 于 资源 被 改变 ， 当 CoAP 客 户 端 再 次 使 用 缓存 的 Etag 时 ，CoAP 服 务 器 将 会 返回 validate 的 最 新 内 容 ; 最 后 通过 DELETE 方 法 删除 资源 。 通 过 该 示例 重点 学 习 Etag 的 使 用 方法 和 2.03 Valid 的 有 具 
体 含义 。 该 示例 的 具体 过 程 如 图 8-10 所 示 。 


CoAP 客 户 端 CoAP 服 务 需 


狐 取 资源 并 缓存 Etag 


resource | 


Get /validate 


2.05 Content 
Etag: OxF96F 完整 啊 应 内 容 


Etag: OxF96F Get /validate 


Etag: OxF96F : 


(EHET: —— 2.03 Valid 无 响应 内 容 
JR 
ET 
PUT /validate 


Etag: 0x9868 Payload: 1234567890 强制 更 新 内 容 


2.04 Changed 


Get /validate 
Etag: OxF96F 


resource | 


Etag: 0x559d 


2.05 Content 1234567890 


Delete /validate 


2.02 Deleted 


图 8-10 “Copper 示例 2 流程 说 明 
(1) 通过 GET 方 法 获取 validate 资 源 
通过 GET 方 法 获取 validate 资 源 ， 具 体 过 程 如 图 8-11 所 示 。 
1) 在 Copper 的 地 址 栏 中 输入 coap: //wsncoap.org: 5683/validate。 
2) 单 击 工具 栏 中 的 GET 按 钮 ， 发 送 CoAP 请 求 。 
3) 若 服 务 器 正确 返回 ， 可 在 Copper 插 件 的 CoAP 选 项 信息 区 域 获取 CoAP 服 务 器 返回 的 Etag， 此 时 返回 的 Etag 为 “0xF69F”， 记 录 该 Etag 值 以 便 下 次 使 用 。 


此 时 CoAP 服 务 器 返回 的 响应 码 为 “2.05 Content”， 响 应 负载 中 包含 具体 内 容 。 


wsncoap.org:5683 


[7] Debug Control 


Header Value Option Value Block1 (Req.) Block2 (Res.)Auto 


Type ACK ETag one O b 


Code 2.05 Content Content-Format text/plain Sizel Size2 


k 
MID 3465 Block2 0 (64 B/block) : 


Token empty :| Observe 


Payload Q7 . 
&J Incoming (3 Rendered 国 Outgoing : ETag 


Type: 0 (CON) | | use hex (0x..) or string X 


Code: 1 (GET) If-Match 


MID: 3465 Ox7540 - 


C] If-None-Match J 
< à > 


图 8-11 通过 GET 方 法 获取 validate 资 源 
(2) 请 求 首部 中 填 入 Etag 选 项 ， 再 次 访问 资源 


再 次 访问 validate 资 源 ， 在 请 求 首部 中 填 入 上 一 步骤 缓存 的 Etag 选 项 值 ， 具 体 过 程 如 图 8-12 所 示 。 


wsncoap.org:5683 


€ 0 coap;//wsncoap.org:5683/validate B) U cC Qng«CtK^ AA + * 多 | -~ 


Ping (EY Discover | KJ cer ÇJ rost E3 rur £3 perete Observe| Payload Behavior - 
2 | Reset | 
* * . . I" De Control 
2.03 Valid (Blockwise) (Download finished) . 


Header Value Value Block1 (Req.) Block2 (Res.) Auto 


pe Ack - z 


Code 2.03 Valid (4) 0 (64 B/block) Sizel Size2 


k 
MID 3466 | | total size X| | total size X 


Token empty | Observe 


— | 
&J Incoming £j Rendered 国 Outgoing : ETag 


If-Match 


use an ETag X 


C] If-None-Match " 
E > 


图 8-12 ”请 求 首部 中 填 入 Etag 选 项 ， 再 次 访问 资源 
1) 在 Copper 的 地 址 栏 中 输入 coap: //wsncoap.org: 5683/validate, 
2) 在 Copper 选 项 区 域 的 Etag 参 数 部 分 填 入 0xF96F。 
3) 单 击 工具 栏 中 的 GET 按 钮 ， 发 送 CoAP 请 求 。 
4) 若 服务 器 正确 返回 ， 在 CoAP 首 部 信息 区 域 可 观察 到 CoAP 响 应 码 为 “2.03 Valid”， 而 且 CoAP 响 应 中 没有 任何 负载 内 容 。 
此 时 服务 器 认为 CoAP 客 户 端 中 缓存 的 负载 与 服务 器 中 的 负载 完全 相同 ， 没 有 必要 把 完全 相同 的 负载 重新 传递 一 次 ， 所 以 返回 的 响应 码 为 “2.03 Valid" , 
(3) 通过 PUT 方法 修改 资源 


通过 PUT 方法 修改 资源 ， 具 体 过 程 如 图 8-13 所 示 。 


wsncoap.org:5683 


(«€ © coap;//wsncoap.org:5683/validate Q Uc Q Bing <Cti+k> AA & A 9*9 - 


Ping Q Discover | Q GET > POST * PUT x DELETE Observe | Payload * Behavior ~ 


3 
2.04 Changed (RTT 21 ms) = Control 


Header Value i Value Block1 ZEY Block2 ZTT )Auto 


Code 2.04 Changed --- 


b 


Token empty ; x 


u— \ 
国 Incoming £j Rendered — &3 Outgoing | ETag 


. use hex (0x..) or string X 
1234567890 e 


If-Match 


use an ETag X 


C] If-None-Match 


T > 


é 


v 


图 8-13 ”通过 PUT 方法 修改 资源 
1) 在 Copper 的 地 址 栏 中 输入 coap: //wsncoap.org: 5683/validate, 
2) 在 CoAP 负 载 内 容 区 域 填 入 请 求 负载 ， 如 字符 串 形 式 的 “1234567890” , 
3) 单 击 工具 栏 中 的 PUT 按钮 ， 发 送 COAP 更 新 请 求 。 
(4) 请 求 首部 中 加 入 Etag 选 项 ， 再 次 访问 资源 
下 面试 图 通过 GET 方 法 再 次 获取 validate 资 源 ， 此 处 填 入 与 第 二 步 完全 相同 的 Etag 参 数 ， 如 图 8-14 所 示 。 
1) 在 Copper 的 地 址 栏 中 输入 coap: //wsncoap.org: 5683/validate, 
2) 在 Copper 选 项 区 域 的 Etag 参 数 部 分 填 入 0xF96F。 
3) 单 击 工具 栏 中 的 GET 按 钮 ， 发 送 CoAP 请 求 。 


4) 若 服务 器 正确 返回 ， 在 CoAP 首 部 信息 区 域 可 观察 到 CoAP 响 应 码 为 “2.05 Content" ， 而 且 CoAP 响 应 中 包含 具体 内 容 “1234567890” , 


wsncoap.org:5683 


€ © coap;//wsncoap.org:5683/validate Qv C Q Bng«Ct-K^ AA € * 9 - 


Ping a Discover e GET - POST + PUT x DELETE Observe. Payload * Behavior ~ 


3 
2.05 Content (Blockwise) (Download finished) t. vias — 


Header Value Option Value Block1 (Req.) Block2 (Res.)Auto 


Type ACK ETag 0x20E32271 "i 


Code 2.05 Content Content-Format text/plain Sizel Size? 


k 
MID 3468 Block2 0 (64 B/block) : 


Token empty | Observe 


Payload (10 \ 
国 Incoming Ç} Rendered 1j Outgoing | ETag 


1234567890] £l oxF96F 想 了 


If-Match 


L] If-None-Match 


MIS LLL E SE 


v 


图 8-14 请求 首部 中 加 入 Etag 选 项 ， 再 次 访问 资源 


虽然 该 步骤 的 CoAP 请 求 和 第 二 步 的 完全 相同 ， 但 却 获 得 了 完全 不 同 的 响应 码 和 响应 负载 。 此 时 CoAP 服 务 器 通过 Etag 判 断 CoAP 客 户 端的 资源 和 服务 器 的 资源 并 不 相同 ， 服 务 器 需要 通过 响应 把 最 新 的 
资源 反馈 至 客户 端 。 通 过 Etag 选 项 可 以 让 CoAP 客 户 端 和 服务 器 判断 资源 的 “新 鲜 度 ” ， 服 务 器 总 是 试图 向 客户 端 反馈 “最 新 鲜 ” 的 资源 。 


(5) 通过 DELETE 方 法 删除 资源 


最 后 通过 DELETE 方 法 删除 validate 资 源 ， 具 体 过 程 如 图 8-15 所 示 。 


wsncoap.org:5683 
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Ping (2) Discover | Ç cer É rost E3 rur 因 veere Observe | Payload + Behavior - 
2 [v] Debug Control 


2.02 Deleted (RTT 24 ms) ^ 


Header Value Block1 (Req.) Block2 (Res.)Auto 


We acK 


Code 2.02 Deleted -| Sizel Size2 


k 


Token empty :| Observe 


— : 


&J Incoming f} Rendered 国 Outgoing 


If-Match 


use an ETag X 


C] tf-None-Match 
d à > 


v 


图 8-15 ”通过 DELETE 方 法 删除 资源 
1) 在 Copper 的 地 址 栏 中 输入 coap: //wsncoap.org: 5683/validate, 
2) 单 击 工具 栏 中 的 DELETE 按 钮 ， 发 送 COAP 请 求 。 
3) 若 服 务 器 正确 返回 ， 将 在 Copper 插 件 的 响应 首部 区 域 获取 "2.02 Deleted” 响 应 码 。 
3.PUT With If-Match 


在 本 示例 中 首先 在 Copper 插 件 的 请 求 负载 区 域 填 入 任意 内 容 ， 通 过 PUT 方法 试图 更 新 validate 资 源 ， 更 新 资源 之 后 将 获得 一 个 Etag， 在 该 示例 中 我 们 将 记录 该 Etag; 接着 在 Copper 插 件 的 请 求 负载 区 
域 填 入 与 上 一 步 不 完全 相同 的 内 容 ， 在 Copper 请 求 选项 区 域 f-Match 选 项 中 填 入 上 一 步 记录 的 Etag 值 ， 通 过 PUT 方法 再 次 更 新 PUT 请 求 ， 此 时 服务 器 的 响应 码 为 “2.04 Changed”， 并 且 把 更 新 之 后 的 
Etag 值 反馈 至 客户 端 ， 但 是 此 时 我 们 并 不 会 记录 该 Etag; 最 后 保持 If-Match 参 数 不 变 ， 重 新 发 送 PUT 请 求 至 服务 器 ， 此 时 CoAP 服 务 器 判断 请 求 中 的 If-Match 值 与 服务 器 的 资源 的 Etag 值 不 同 ， 请 求 无 效 并 
返回 “4.12 Precondition Failed”。 具 体 流程 如 图 8-16 所 示 。 


CoAP 客 户 端 CoAPJI A RS 


PUT /validate 


2.04 Changed 
Etag: 0x7909] BEA 


PUT /validate : 
If-Match: 0x79091BEA ! 


2.04 Changed 
Etag: Ox IF05845B 


PUT /validate 1234567890 | 


If-Match: 0x79091 BEA 


匹配 成 功 


4.12 Precondition Failed 匹配 失败 


图 8-16 Copper 插件 示例 3 流程 说 明 
(1) 通过 PUT 方法 更 新 validate 资 源 

通过 PUT 方法 更 新 validate 资 源 ， 具 体 过 程 如 图 8-17 所 示 。 

1) 在 Copper 地 址 栏 中 输入 coap: //wsncoap.org: 5683/validate, 

2) 在 Copper 负 载 内 容 区 域 请 求 负载 内 容 部 分 填 入 “1234567890”。 

3) 单 击 工具 栏 中 的 PUT 按钮 ， 发 送 CoAP 更 新 请 求 。 


若 服务 器 正确 返回 ， 在 Copper 响 应 首部 区 域 可 观察 到 CoAP 响 应 码 为 “2.04 Changed”， 而 且 响 应 中 Etag 的 值 为 0x79091BEA， 记 录 该 Etag 的 值 并 填 入 下 一 步 的 If-Match 选 项 中 。 


wsncoap.org:5683 
€ © | coap;//wsncoap.org:5683/validate & U c QQ Big «Ctri-K» 48-1 


Ping (2) Discover | ÇJ cer L3 rost E3 rur £3 oausr Observe | Payload - Behavior - 
Debug Control 


3 
2.04 Changed (RTT 2040 ms) j 


Size 


Header Value i Value total size X total size X X total size X total size X X 


Type ACK 0x79091BEA Observe 


Code 2104 Changed | 


MID 45078 :| ETag 
Token empty : use hex (Ox..) or string X 


Payload | If-Match 


国 Incoming 四 Rendered k Outgoing : 


1234567890 e i [ ] I-None-Match 
D E Host ra Port 


S 


am—— 


图 8-17 ”通过 PUT 方法 更 新 validate 资 源 

(2) 填 入 If-Match 选 项 ， 再 次 更 新 validate 资 源 
在 请 求 负 载 区 域 写 入 不 同 于 上 一 次 的 内 容 ， 填 入 If-Match 参 数 并 再 次 发 送 CoAP 更 新 请 求 ， 具 体 过 程 如 图 8-18 所 示 。 

1) 在 Copper 地 址 栏 中 输入 coap: //wsncoap.org: 5683/validate。 

2) 在 Copper 负 载 内 容 区 域 请 求 负载 内 容 部 分 填 入 “ABCDEFGHI 

3) 在 Copper 请 求 选 项 部 分 ，If-Match 参 数 填 入 上 一 步 缓存 的 Etag 值 ， 此 时 If-Match=0x79091BEA。 

4) 单 击 工 具 栏 中 的 PUT 按钮 ， 发 送 CoAP 更 新 请 求 。 

若 服务 器 正确 返回 ， 在 Copper 响 应 首部 区 域 可 观察 到 CoAP 响 应 码 应 为 “2.04 Changed" ， 但 响应 中 Etag 的 值 变 为 0x1F05845B， 此 时 我 们 并 不 记录 更 新 之 后 的 Etag。 
(3) 依然 填 入 If-Match 选 项 ， 再 次 更 新 validate 资 源 

最 后 更 新 请 求 负载 部 分 的 内 容 ，|f-Match 保 持 不 变 ， 再 次 通过 PUT 请 求 更 新 validate 资 源 。 由 于 If-Match 参 数 没有 得 到 及 时 更 新 ， 所 以 COAP 服 务 器 将 会 拒绝 本 次 PUT 请 求 。 具 体 过 程 如 图 8-19 所 示 。 
1) 在 Copper 地 址 栏 中 输入 coap: //wsncoap.org: 5683/validate。 

2) 在 Copper 负 载 内 容 区 域 请 求 负载 内 容 部 分 填 入 “1234567890” 或 其 他 任意 值 。 


3) 在 Copper 请 求 选 项 部 分 ，If-Match 参 数 填 入 第 一 步 保 存 的 Etag 值 ， 此 时 If-Match= 0x79091BEA。 


wsncoap.org:5683 


| € © coap://wsncoap.org:5683/validate@ Ug c QQ Bing «Ctri*K» wB + el 
Ping (2) Discover | ÇJ cer E rost E Pur £3 onere Observe | Payload - Behavior - 
4 回 Debug Control 
2.04 Changed (RTT 28 m — 


Sizel 


Header Value i Value total size X| size total size X| total size X size total size X 


Type ACK 0x1F05845B 


Code 204 Changed | 


MID 45079 : ET. ag 


Token emp | 


£3 Incoming (Jj Rendered — i Outgoing :| [Ox79091BEA 3 x 


ABCDEFGHIJ e [ ] f-None-Match 
OT Host mE Port 


Lt 


-——— E 


图 8-18” 填 入 If-Match 选 项 ， 再 次 更 新 Validate 资 源 


在 第 二 步 中 ，validate 的 资源 已 经 被 更 新 ， 更 新 之 后 的 Etag 值 为 0x1F05845B， 而 此 时 请 求 中 的 If-Match 值 为 0x79091BEA， 两 者 不 匹配 。 此 时 服务 器 返回 的 响应 码 为 “4.12 Precondition Failed" 


[XI] wsncoap.org:5683 x ww 


€ © coap:;//wsncoap.org:5683/validate € gc Q, Bing «Ctrl-K» 7A & el 三 


(9) Ping Q Discover e GET fkg POST $4 PUT L3 DELETE by Observe | Payload * Behavior - [] 


4.12 Precondition Failed (RTT 45 ms) E] Debug Control P Reset 


Header Value 

Type ACK 

Code 4.12 Precondition Fail... 
MID 45080 

Token empty 


Payload If-Match 


© Incoming f} Rendered k Outgoing : 0x79091BEA 3 x 


1234567890 eG C] If-None-Match 
Uri-Host Uri-Port 


图 8-19 ”依然 填 入 IEMatch 选 项 ， 再 次 更 新 Validate 资 源 


8.3 Wireshark 


Wireshark 是 一 款 网 络 抓 包 分 析 软 件 。Wireshark 获 取经 过 网 卡 的 网 络 分 组 数据 ， 并 尽 可 能 显示 最 为 详细 的 分 组 数据 分 析 结 果 。CoAP 的 请 求 响 应 过 程 也 可 以 通过 Wireshark 抓 取 ，Wireshark 不 但 可 以 抓 
取 CoAP 分 组 数据 ， 还 可 以 准确 地 分 析 CoAP 分 组 数据 中 各 种 细节 。 


8.3.1 Wireshark 安 装 


Wireshark 官 网 提供 Windows 32 位 和 64 位 的 安装 文件 ， 用 户 可 根据 电脑 的 实际 配置 安装 合适 的 版 本 。Wireshark 不 但 提供 安装 包 也 提供 源 代码 ， 通 过 源 代码 的 方式 用 户 可 在 Linux PC 主机 中 安装 
Wireshark。 虽 然 CoAP 有 不 少 实现 框架 ,但 有 不 少 CoAP 框 架 仅 能 在 Linux 平 台中 运行 。 在 这 种 情况 下 ， 往 往 需 要 在 Linux 主 机 中 安装 Wireshark 以 便 分 析 CoAP。 


下 面 介绍 如 何在 Linux PC 主机 中 通过 源 代码 方式 安装 Wireshark。 在 Linux PC 主机 中 通过 源 代码 方式 安装 软件 的 过 程 大 致 经 过 configure、make 和 make install 这 三 部 分 。 一 般 情 况 下 make install 需 要 
把 编译 生成 的 库 文件 和 可 执行 文件 复制 到 根 目录 指定 位 置 ， 所 以 往往 需要 超级 权限 。 安 装 Wireshark 之 前 需要 在 Linux 主 机 中 安装 必要 的 依赖 包 ， 由 于 每 一 个 Linux 发 行 版 都 不 完全 相同 ， 用 户 需要 根据 实际 


情况 安装 必要 的 依赖 包 。 


sudo apt-get build-dep wireshark 
sudo apt-get install qt5-default 
sudo apt-get install libssl-dev 


此 处 的 Wireshark 源 代码 版 本 为 2.0.3， 请 根据 源 代 码 的 具体 版 本 蔡 换 此 处 的 2.0.3。 


# 解压 安装 包 

tar -jxvf wireshark-2.0.3.tar.bz2 
# 进入 源 代码 目录 

cd wireshark-2.0.3 

# 生成 配置 文件 ， 使 能 SSIL 功 能 
./autogen.sh 

./configure --with-ssl --enable-setcap-install 
# 编译 

make 

# 安装 wireshark 

sudo make install 


8.3.2 ”Wireshark 使 用 


Wireshark 在 Windows 和 Linux 中 的 使 用 极为 相似 ， 若 在 Linux 中 打开 Wireshark 可 先 新 建 一 个 控制 台 并 在 控制 台中 输入 wireshark 保 持 控制 台 处 于 运行 状态 即 可 。 开 始 抓 取 CoAP 数 据 之 前 需要 设置 正确 
的 网 卡 ， 请 根据 实际 情况 选择 有 线 网 卡 或 无 线 网 卡 。 打 开 Wireshark 之 后 ， 选 择 “ 菜 单 栏 一 捕获 一 选项 ”。Windows 中 网 卡 的 名 称 和 Linux 中 的 略 有 差别 ，Windows 中 有 线 网 卡 的 名 称 为 “本 地 连接 ” (Ul 


图 8-20) ， 而 Linux 中 有 线 网 卡 的 名 称 为 “eth0” ( 见 图 8-21) 。 


M Wireshark - 捕获 接口 


输入 输出 选项 


接口 流量 
Bluetooth 网 络 连 接 2 


HAEE 
LLL Ethernet 
HAUS Ethernet 

Ethernet 
VMware Network Adapter VMnet8 ~~~. ~ À Ethernet 
VMware Network Adapter VMnet1 . .. . ~ À Ethernet 
本 地 连接 * 4 Ethernet 
本 地 连接 * 2 Ethernet 


I7] 在 所 有 接口 上 使 用 混杂 模式 
所 选择 接口 的 捕获 过 滤器 : | 贞 | 输入 捕获 过 滤器 … 


图 8-20 ”Windows 中 选择 网 卡 


(9$ wireshark - Capture Interfaces 


Input | Output | Options | 


» etho -从 Ethernet 
bluetootho Bluetooth HCI U...s pseudo-header 
nflog ~ Linux netfilter log messages 
nfqueue -Raw IPv4 
any MA ALinuxcooked 

* Loopbacklo ^ . ~ Ethernet 


enabled 
enabled 
enabled 
enabled 
enabled 
enabled 


default 
default 
default 
default 
default 
default 


Snapk (B) F (MB) Hse 


2 


interface Traffic Link-layer Header Promiscuous Snaplen (B) |Buffer (MB) Monitor Mod Ci 


n/a 
n/a 
n/a 
n/a 
n/a 
n/a 


人 


| Manage Interfaces... | 
Capture filter for selected interfaces: | 由 | Enter a capture filter ... | 


© Enable promiscuous mode on all interfaces 


, Compile BPFs | 


Start | 


图 8-21 Linux 中 选择 网 卡 
为 了 更 方便 地 分 析 CoAP 分 组 数据 ， 需 要 在 Wireshark 中 设置 合适 的 过 滤 规则 。Wireshark 的 过 滤器 设置 位 于 工具 栏 下 方 。 如 图 8-22 所 示 。 
可 通过 多 种 方式 过 滤 CoAP 分 组 报 文 ， 这 些 方法 包括 : 


在 过 滤器 中 输入 “coap” : Wireshark 将 过 滤 所 有 CoAP 分 组 数据 ， 这 些 分 组 数据 包括 CoAP 请 求 、CoAP 响 应 等 。 


4WOo |mnmmaqeezgugzimamemesr 


Destination Protocol 
129.132.15.88 CoAP 
192.168.2.101 CoAP 
129.132.15.88 CoAP 
192.168.2.101 CoAP 
129.132.15.88 CoAP 


Time Source 


80 14.132311 3192.168.2.101 


86 14.400299 129.132.15.80 
8/ 14.424859 3192.168.2.101 
88 14.669397 129.132.15.80 
90 14.688579 3192.168.2.101 


图 8-22 ”Witeshatk 过 滤器 设置 


. 在 过 滤器 中 输入 “udp.port==5438”: CoAP 分 组 数据 由 UDP 负责 传输 ， 一 般 情 况 下 CoAP 分 组 数据 的 端口 号 为 5438， 可 使 用 过 滤 指 定 UDP 端 口号 的 方式 获取 CoAP 分 组 数据 。 如 果 CoAP 分 组 数据 并 未 使 


用 5438 端 口 ， 如 运行 于 5439 端 口 ， 那 么 过 滤 条 件 为 udp.pofrt==5439。 


. 在 过 滤器 中 输入 “ipb.addr==192.168.1.102&c&cudp.port==5438”: 这 种 过 滤 方 式 可 以 指定 CoAP 分 组 数据 来 自 于 哪里 ， 如 此 处 指定 CoAP 分 组 数据 来 自 于 IP 地 址 为 192.168.1.102 的 主机 。 若 需要 过 滤 IPv6 地 
址 ， 可 在 过 滤器 中 输入 “ipv6.address==<ipv6 address? &&udp.port-—5438" 。 


8.3.3 ”Wireshark 示 例 

本 小 节 将 结合 Copper 揪 件 和 Wireshark， 通 过 几 个 示例 说 明 如 何 使 用 Wireshark 分 析 CoAP。 本 小 节 中 CoAP 客 户 端 使 用 Copper 揪 件 ， 而 CoAP 服 务 器 沿用 coap: //wsncoap.org 提 供 的 测试 服务 。 除 了 
使 用 测试 服务 器 之 外 ，CoAP 客 户 端 和 CoAP 服 务 器 也 可 以 使 用 Nodejs 或 Java 等 其 他 方式 实现 。 

1.NON-GET/test 


Wireshark 的 第 一 个 示例 与 NON 类 型 请 求 有 关 ， 之 前 的 示例 中 均 使 用 CON 类 型 请 求 ，NON 类 型 请 求 与 CON 类 型 请 求 稍 有 差异 。CoAP 中 ，CON 请 求 的 响应 必须 为 ACK 类 型 ， 若 请 求 为 NON 类 型 ， 那 么 
CoAP 服 务 器 可 以 选择 不 返回 响应 也 可 返回 NON 类 型 的 响应 。 第 一 个 示例 中 ，CoAP 客 户 端 将 发 送 一 个 NON 类 型 的 GET 请 求 ， 试 图 获取 服务 中 的 test 资 源 ;' CoAP 服 务 器 返回 一 个 NON 类 型 的 响应 ， 而 响应 
码 为 “2.05 Content" ， 有 具体 流程 如 图 8-23 所 示 。 


CoAPII 4$ 


NON GET /test i 


NON 2.05 Content | 


图 8-23 NON GET 请 求 
1) 打开 Wireshark， 在 过 滤器 中 输入 “coap”。 
2) 在 Copper 地 址 栏 中 输入 coap: //wsncoap.org: 5683/test。 


3) 在 Copper 工 具 栏 中 打开 “Behavior” 菜单 ， 选 择 “NON requests”， 此 时 Copper 将 发 送 NON 类 型 的 请 求 。Behavior 菜 单 如 图 8-24 所 示 。 


Retransmissions 


Send Duplicates 


图 8-24 ”Behavior 菜单 


4) 单 击 工具 栏 中 的 GET 按 钮 ， 发 送 NON 类 型 CoAP 请 求 。 


虽然 请 求 为 NON 类 型 ， 但 是 CoAP 测 试 服务 器 依然 会 返回 响应 ， 响 应 码 仍 为 “2.05 Content”。Wireshark 中 获取 的 网 络 分 组 数据 如 图 8-25 所 示 。 


l——— m 表达 式 … | + BIRREDIDUES 
Time Source Destination Protocol Length Info 
3304 85.781761 192.168.1.21 139.196.187.107 CoAP 60 NON, MID:17871, GET, End of Block #0, /test 
3305 85.799186 139.196.187.107 192.168.1.21 CoAP 90 NON, MID:58645, 2.05 Content, End of Block #0 (text/plain) 


User Datagram Protocol, Src Port: 5683, Dst Port: 50667 
Constrained Application Protocol, Non-Confirmable, 2.05 Content, MID:58645 
01.. .... = Version: 1 
..01 .... - Type: Non-Confirmable (1) 
.... 0000 = Token Length: 8 
Code: 2.05 Content (69) 
Message ID: 58645 
Opt Name: #1: Content-Format: text/plain; charset-utf-8 
Opt Name: #2: Max-age: 30 
Opt Name: #3: Block2: NUM:0, M:0, SZX:64 
End of options marker: 255 
[Request In: 3304] 
[Response Time: 0.017425000 seconds] 
Payload: Payload Content-Format: text/plain; charset-utf-8, Length: 38 


图 8-25 Wireshark NON-GET 
2.GET/separate 


Wireshark 的 第 二 个 例子 与 CoAP 分 离 模 式 有 关 ， 在 携带 模式 中 CoAP 请 求 和 响应 由 两 个 UDP 包 实现 ， 而 在 分 离 模式 中 由 4 个 UDP 包 实现 。 在 分 离 模 式 中 将 出 现 空 应 答 类 型 CoOAP 报 文 ， 具体 流程 如 图 8-26 
所 示 。 


CoAP 上 服务 入 


GET /separate 
^us 


2.05 Content 


| 空 应 管 


图 8-26 GET/separate 
1) 重新 打开 Wireshark， 在 过 滤器 中 输入 “coap” 
2) 在 Copper 地 址 栏 中 输入 coap: //wsncoap.org: 5683/separate, 
3) 在 Copper 工 具 栏 中 打开 “Behavior” 菜 单 ， 重 新 选择 “CON requests” 把 请 求 类 型 重新 恢复 为 CON 类 型 。 
4) 单 击 工 具 栏 中 的 GET 按 钮 ， 发 送 CoAP 请 求 。 


在 Wireshark 中 可 以 获取 4 组 网 络 数据 ， 其 中 第 二 组 网 络 分 组 数据 较为 特殊 ， 该 组 网 络 数据 为 CoAP 服 务 器 返回 至 CoAP 客 户 端的 “ 空 应 答 ”， 在 CoAP 中 空 应 答 的 Code 区 域 的 值 为 0x00。Wireshark 中 获 


取 的 网 络 分 组 数据 如 图 8-27 所 示 。 


+ ”应 用 此 过 滤器 
Destination Protocol Length Info 
1346 27.406343 192.168.1.21 139.196.187.107 CoAP 64 CON, MID:41454, GET, End of Block #0, /separate 
1347 27.421704 139.196.187.107 192.168.1.21 CoAP 60 ACK, MID:41454, Empty Message 
1375 28.421907 139.196.187.107 192.168.1.21 CoAP 89 CON, MID:58646, 2.05 Content, End of Block 40 (text/plain) 
1377 28.471965 192.168.1.21 139.196.187.107 CoAP 46 ACK, MID:58646, Empty Message 


Frame 1347: 60 bytes on wire (480 bits), 60 bytes captured (480 bits) on interface 0 


Ethernet II, Src: ChengduV 45:f3:2b (ec:6c:9f:45:f3:2b), Dst: LcfcHefe a0:87:8d (50:7b:9d:a0:87:8d) 
Internet Protocol Version 4, Src: 139.196.187.107, Dst: 192.168.1.21 
User Datagram Protocol, Src Port: 5683, Dst Port: 57886 
Constrained Application Protocol, Acknowledgement, Empty Message, MID:41454 
01.. .... = Version: 1 
..10 .... = Type: Acknowledgement (2) 
.... 0000 = Token Length: 8 
Code: Empty Message (0) 
Message ID: 41454 


图 8-27 Wireshark GET /separate 
3. 观 察 者 模式 


Wireshark 的 第 三 个 例子 与 CoAP 观 察 者 模式 有 关 。 通 过 Copper 插 件 观 察 CoAP 测 试 服务 器 中 的 obs 资 源 ， 观 察 一 段 时 间 之 后 再 停止 观察 。 具 体 流程 如 图 8-28 所 示 。 


CoAP 观 察 者 CoAP 资 源 


GET /osb | 
| Observe: 0 0 
Ve > 注册 请 求 
2.05 Content | 
Max-Age:5 
| “16:12:10” | 


m—m——————— >， 系统 时 间 指 示 
| 2.05 Content | 
! Max-Age:5 
*16:12:15" 


l | 
l | 
l l 1 | 
| GET /obs ! 
l | 
— LR ^ * EN AN 
| Observe: 1 注销 请 求 
l | 
1) 重新 打开 Wireshark， 在 过 滤器 中 输入 “coap”。 
2) 在 Copper 地 址 栏 中 输入 coap: //wsncoap.org: 5683/obs, 


3) 在 Copper 工 具 栏 中 打开 “Behavior” 菜单 ， 选 择 停止 观察 模式 方式 ， 可 选择 “GET Observe Cancel”，Behavior 菜 单 如 图 8-29 所 示 。 若 选择 “GET Observe Cancel”，Copper 插 件 通 过 发 送 一 
个 特殊 的 GET 请 求 以 停止 观察 者 模式 ， 在 该 特殊 的 CET 请 求 中 observe 选 项 值 为 1。 


Block late negotiation 
Block size 16 
Block size 32 
Block size 64 
Block size 128 
Block size 256 
Block size 512 
Block size 1024 


Observe Token 


v Observe cancel 


GET Observe cancel 


RST Observe cancel 


- 


图 8-29 Behavior 菜单 修改 停止 观察 方式 


4) 单 击 工具 栏 中 的 Observe 按 钮 ， 启 动 观察 。 一 旦 启动 观察 ，Observe 按 钮 将 变 为 Cancel 按 钮 。 


5) 经 过 一 段 时 间 之 后 点 击 工具 栏 中 的 Cancel 按 钮 ， 以 停止 观察 者 模式 。 


通过 Wireshark 可 以 获得 多 组 网 络 数据 ， 包 括 用 于 启动 观察 的 GET 请 求 ， 该 GET 请 求 中 observe 选 项 的 值 为 0; CoAP 服 务 器 返回 响应 报 文 ， 该 报 文 可 称 为 指示 报 文 ， 指 示 报 文 内 容 为 字符 串 形 式 的 系统 时 
间 ， 该 报 文 的 响应 码 为 “2.05 Content" ; 对 于 每 一 个 指示 报 文 ，CoAP 客 户 端 将 会 返回 一 个 空 应 答 ; 最 后 点 击 Copper 插 件 工 具 栏 的 “Cancel” 时 ，Copper 插 件 将 会 发 送 一 个 特殊 的 GET 请 求 ， 请 求 选项 
中 的 observe 值 为 1 表示 停止 观察 。Wireshark 中 获取 的 网 络 数据 如 图 8-30 所 示 。 


+ ”应 用 此 过 滤器 
Destination Protocol Length Info 
4763 110.532830 : E: Ens 139.196.187.107 CoAP 62 CON, , GET, TKN:cf d4, End of Block #0, /obs 
4765 110.551345 n .187.107 192.168.1.21 CoAP 66 ACK, : , 2.05 Content, TKN:cf d4, End of Block #6 (t... 
4775 110.947007 . .187.107 192.168.1.21 CoAP 64 CON, = , 2.05 Content, TKN:cf d4 (text/plain) 
4777 110.988286 a E Ea 139.196.187.107 CoAP 46 ACK, : Empty Message 
4906 115.947366 i .187.107 192.168.1.21 CoAP 64 CON, : , 2.05 Content, TKN:cf d4 (text/plain) 
4907 115.978829 . VASTE 139.196.187.107 CoAP 46 ACK, : Empty Message 
5006 119.776631 . E 139.196.187.107 CoAP 54 CON, : , GET, TKN:cf d4, /obs 
5007 119. 793887 n .187.107 192.168.1.21 CoAP 60 ACK, - , 2.05 Content, TKN:cf d4 (text/plain) 


> User Datagram Protocol, Src Port: 52928, Dst Port: 5683 
v Constrained Application Protocol, Confirmable, GET, MID:15034 
ME oo (inire Version: 1 
..00 .... = Type: Confirmable (80) 
.... 0010 - Token Length: 2 
Code: GET (1) 
Message ID: 15034 
Token: cfd4 


> Opt Name: #1: 


> Opt Name: #2: Uri-Path: obs 


图 8-30 Wireshark £z zz JS XX, 


8.44 本章 小 结 


本 章 主 要 介绍 了 两 种 CoAP 的 调试 工具 一 Firefox 浏 览 器 中 的 Coppet 插 件 和 网 络 嗅 探 器 Wireshatk ， 本 质 上 来 说 ，CoAP 的 调试 技巧 与 HTTP 的 调试 技巧 非常 相似 。Coppetr 插 件 并 不 是 CoAP 全 能 工具 ， 它 只 是 
一 款 CoAP 客 户 端 工具 。 在 Coppet 播 件 介绍 部 分 详细 说 明了 如 何 设置 CoAP URI， 如 何 填充 CoAP 请 求 负载 ， 如 何 设置 CoAP 条 件 请 求 参 数 ， 如 何 观察 CoAP 响 应 码 等 。 在 Witesha 剑 部分， 介绍 了 如 何在 Windows 平 
合 和 Linux 平 台 安 装 Wireshark， 并 详细 介绍 了 如 何 过 滤 CoAP 报 文 的 三 种 不 同方 法 ; 在 Wireshatk 部 分 也 通过 三 个 不 同 的 示例 展示 了 CoAP NON 类 型 请 求 、 分 离 模式 和 观察 者 模式 的 具体 工作 流程 。 通 过 Coppet 播 
件 和 Witeshatk 工 具 的 配合 使 用 ， 可 以 帮助 用 户 了 解 CoAP 细 节 ， 在 实际 的 开发 过 程 中 发 现 错误 并 最 终 解决 问题 。 


第 9 章 ”微型 物 联网 系统 一 一 服务 器 部 分 


91 ”本章 主 要 内 容 


本 章 将 使 用 树 莓 派 3 代 实现 一 个 更 为 接近 真实 场景 的 应 用 。 在 这 个 应 用 中 ， 树 莓 派 作为 服务 器 ， 此 处 树 莓 派 不 但 提供 CoAP 服 务 ， 还 提供 HTTP Web 服 务 。 树 莹 派 将 接收 传感器 的 请 求 并 将 历史 数据 保存 
至 MySQL 数 据 库 中 ， 另 外 用 户 可 通过 树 莓 派 提 供 的 Web 服 务 以 网 页 方式 查看 历史 数据 。 为 了 更 加 接近 实际 ， 本 章 还 加 入 了 需求 分 析 、 原 型 设计 和 详细 设计 等 部 分 ， 这 可 以 让 读者 更 好 地 了 解 物 联 网 系统 的 设 
计 方 法 和 流程 。 从 物 联网 系统 组 成 结构 来 看 ，CoAP 应 用 绝 不 会 孤立 存在 ， 而 应 与 Web 前 端 、Web 后 端 和 数据 库 技术 等 技术 相互 配合 。 本 章 将 重点 说 明 这 些 技术 如 何 配合 使 用 。 


第 9 草 ”微型 物 联网 系统 一 一 服务 器 部 分 


91 本章 主 要 内 容 


本 章 将 使 用 树 莓 派 3 代 实现 一 个 更 为 接近 真实 场景 的 应 用 。 在 这 个 应 用 中 ， 树 莓 派 作为 服务 器 ， 此 处 树 莓 派 不 但 提供 CoAP 服 务 ， 还 提供 HTTP Web 服 务 。 树 著 派 将 接收 传感器 的 请 求 并 将 历史 数据 保存 
至 MySQL 数 据 库 中 ， 另 外 用 户 可 通过 树 莓 派 提 供 的 Web 服 务 以 网 页 方式 查看 历史 数据 。 为 了 更 加 接近 实际 ， 本 章 还 加 入 了 需求 分 析 、 原 型 设计 和 详细 设计 等 部 分 ， 这 可 以 让 读者 更 好 地 了 解 物 联 网 系统 的 设 
计 方 法 和 流程 。 从 物 联网 系统 组 成 结构 来 看 ，CoAP 应 用 绝 不 会 孤立 存在 ， 而 应 与 Web 前 端 、Web 后 端 和 数据 库 技术 等 技术 相互 配合 。 本 章 将 重点 说 明 这 些 技术 如 何 配合 使 用 。 


9.2 ”假想 需求 


在 开始 本 章 的 内 容 之 前 ， 我 们 先 假想 一 个 需求 并 在 这 个 假想 需求 的 基础 上 开始 系统 的 原型 设计 、 详 细 设 计 以 及 具体 的 代码 实现 。 假 想 需求 包括 以 下 内 容 ( 见 图 9-1) : 


* 设计 一 个 传感器 历史 数据 查询 系统 ， 可 以 查看 每 个 设备 的 任意 一 个 传感器 的 历史 数据 。 


- 单个 设备 具有 三 个 传感器 : 温度 传感器 、 湿 度 传 感 器 和 光照 传感器 。 

' 单个 设备 将 定时 推送 传感器 检测 结果 。 

` 服务 器 可 同时 接收 多 个 设备 请 求 ， 解 析 设 备 请 求 内 容 之 后 保存 至 数据 库 中 。 
. 具有 设备 管理 与 查询 界面 ， 可 通过 Web 页 面 查看 设备 信息 、 历 史 信 息 。 


. 设备 管理 与 查询 界面 美观 大 方 ， 便 于 用 户 使 用 。 


设备 A 


传 感 硕 结 朱 { 温 度 、 湿 度 、 光 照 ) 
设备 B 


—, Y 全 


on ^w HT nr Ir 2*t.- 400 ^w 


-a di = : 二 
TENTE. 
设备 管理 与 查询 界面 
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图 9-1 假想 需求 说 明 


9.3 ”原型 设计 


在 了 解 系统 需求 之 后 我 们 便 可 着 手 开始 后 续 的 原型 设计 。 原 型 设计 可 以 帮助 工程 师 了 解 该 做 些 什么 、 系 统 有 哪些 功能 等 基本 问题 。 大 多 数 物 联网 系统 都 包含 很 多 部 分 ， 这 些 部 分 可 能 包括 CoAP 部 分 、 
Web 前 端 、Web 后 端 和 数据 库 ， 甚 至 还 可 能 包括 数据 分 析 和 机 器 学 习 等 内 容 。 获 取 物 联网 系统 的 需求 之 后 ， 应 该 着 手 进行 必要 的 设计 工作 ， 此 时 开始 写 代码 并 实现 具体 功能 绝对 不 是 一 个 好 “主意 ”。 


9.3.1 “系统 结构 识 明 


若 从 具体 的 需求 入 手 ， 那 么 该 物 联网 系统 大 致 可 以 分 为 3 个 部 分 一 一 设备 交互 部 分 、Web 系 统 部 分 、 数 据 库 部 分 。 系 统 的 组 成 结构 如 图 9-2 所 示 。 

(1) 设备 交互 部 分 

设备 交互 部 分 负责 接收 传感器 请 求 内 容 ，CoAP 可 以 非常 好 地 胜任 该 部 分 工作 ，CoAP 使 设备 可 以 方便 地 接 入 传统 互联 网 ，CoAP 具 有 很 多 HTTP 的 特性 ， 这 也 使 得 系统 开发 变 得 更 容易 。 
(2) Web 系 统 部 分 


物 联网 系统 具有 一 个 设备 管理 和 查询 界面 ， 该 部 分 是 一 个 典型 的 Web 系 统 ， 而 Web 系 统 设计 一 般 可 分 为 前 端 设 计 和 后 端 设计 两 部 分 。Web 前 端 负 责 展现 页 面 ， 提 供 必 要 人 机 交互 操作 ; Web 后 端 负 责 
处 理 所 有 的 请 求 路 由 。 


(3) 数据 库 部 分 


对 于 绝 大 多 数 物 联网 或 者 Web 系 统 来 说 ， 数 据 保存 与 查询 是 不 可 或 缺 的 部 分 ， 该 系统 需要 及 时 保存 设备 上 传 的 传感器 数据 。 


Web 系 统 部 分 数据 库 部 分 


设备 交互 部 分 


Webiij Ym Web 后 端 


图 9-2 ”系统 结构 组 成 说 明 


9.3.2 ”系统 流程 设计 
对 系统 组 成 有 一 个 明确 的 认识 之 后 ， 便 可 着 手 规范 系统 运行 过 程 中 的 相关 流程 。 与 多 数 传统 的 Web 系 统 不 同 ， 物 联网 系统 中 总 是 有 设备 参与 。 在 一 些 移动 Web 系 统 中 ， 也 存在 移动 设备 的 概念 ， 但 是 此 


处 的 移动 设备 多 指 智 能 手机 ， 这 些 设 备 的 运算 和 存储 能 力 远 远 超过 那些 物 联网 设备 。 在 系统 流程 设计 中 应 该 适当 “迁就 ” 物 联网 设备 ， 简 化 设备 的 交互 过 程 。 流 程 设计 主要 表现 设备 、 用 户 和 系统 之 间 相 互 
操作 的 关系 。 微 型 物 联网 系统 工作 流程 如 图 9-3 所 示 。 


设备 


CoAP Server 
时 间 间 陋 : 


GET 获取 设备 列表 


w ，=3= 有 = 
响应 {设备 A, 设 备 B...} 


GET 指 定 设 备 历史 信息 


HTTP Server 


ae O 
响应 { 设 备 历 史 数据 } 
图 9-3 ”系统 流程 设计 


在 该 物 联网 系统 中 ， 设 备 根据 间隔 时 间 t 周 期 性 地 推送 传感器 结果 ， 传 感 器 结果 包含 一 组 温度 、 湿 度 和 光照 检测 数据 。 设 备 的 工作 流程 相对 比较 简单 ， 而 用 户 的 交互 流程 要 稍微 复杂 一 些 ， 用 户 可 以 获得 
物 联网 系统 中 包含 了 哪些 设备 ， 物 联网 系统 可 以 返回 一 个 设备 列表 。 另 外 ， 用 户 还 可 以 选择 一 个 具体 的 设备 查看 其 历史 信息 。 该 流程 中 用 户 需要 先 获 取 设 备 列 表 ， 再 获取 单个 设备 的 历史 信息 。 最 后 ， 用 户 
可 以 选择 单个 设备 也 就 意味 着 设备 具有 唯一 的 编号 。 设 备 编号 的 方法 有 很 多 种 ， 可 以 在 出 三 时 提前 写 入 设备 中 ， 也 可 以 使 用 设备 本 身 的 信息 ， 如 网 卡 地 址 或 CPUID 等 。 


9.3.3 ”网 页 原型 设计 


即使 在 以 设备 为 主 的 物 联网 系统 中 ， 人 机 交互 界面 依然 是 设计 的 重 中 之 重 ， 因 为 只 有 当 传感器 数据 经 过 排列 组 合 或 经 过 特殊 处 理 之 后 重新 展现 给 最 终 用 户 时 ， 这 些 数据 才 体现 出 价值 。 本 系统 中 仅 包 括 
单个 动态 页 面 。 该 动态 页 面 采用 左 侧 导 航 栏 、 右 侧 数 据 表 格 这 样 的 布局 方式 。 在 左 侧 导航 栏 展 示 设 备 列表 ， 点 击 导航 列表 中 任意 一 项 便 可 查看 具体 设备 的 历史 信息 ， 网 页 将 重新 载 入 并 且 右 侧 的 表格 内 容 也 
将 全 部 更 新 。 右 侧 的 数据 表格 展示 相关 历史 数据 ， 数 据 表格 中 包括 序号 、 设 备 编号 、 温 度 传感器 数据 、 湿 度 传感器 数据 、 光 照 数 据 和 上 报时 间 记 录 ， 这 些 内 容 可 以 通过 各 种 方式 排列 ， 例 如 可 以 按照 上 报时 
间 逆 序 排列 。 如 果 数 据 内 容 太 多 ， 数 据 表格 应 加 入 分 页 功能 。 动 态 网 页 的 原型 如 图 9-4 所 示 。 


< D» *) A Q, https://www.examplem.com 


2010:08:23 12:24:25 
2016:08:23 12:25:25 
2016:08:23 12:28:25 
2016:08:23 12:34:25 
2016:08:23 12:24:25 
2016:08:23 12:25:25 
2016:08:23 12:28:25 
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图 9-4 单个 设备 历史 信息 页 面 原型 


94 详细 设计 


详细 设计 部 分 是 除了 代码 实现 部 分 之 外 最 具 挑 战 性 的 部 分 ， 该 部 分 是 物 联网 系统 实现 过 程 中 最 重要 的 部 分 。 


9.4.1 ”技术 选 型 品 明 


技术 选 型 是 微型 物 联网 系统 详细 设计 的 第 一 步 ， 技 术 选 型 往往 是 一 个 协调 和 妥协 的 工作 ， 世 界 上 并 不 存在 最 好 的 技术 ， 只 存在 最 合适 的 技术 。 本 例 中 数据 库 使 用 MySQLI1]，CoAP 服 务 使 用 node-coap 
框架 ，Web 后 端 使 用 基于 Nodejs 的 ExpressI] 框 架 ，Web 前 端 主要 使 用 Bootstrap 框 架 。 为 了 尽 可 能 降低 开发 难度 ， 无 论 是 Web 前 端 后 端 ， 还 是 CoAP 服 务 器 ， 均 使 用 JavaScript 语 言 。 


1. 数 据 库 


与 Web 前 后 端 技术 手段 一 样 ， 数 据 库 也 有 很 多 种 选择 。 本 系统 选择 MySQL 数 据 库 ，MySQL 是 一 款 开 放 源 代码 的 关系 型 数据 库 ， 该 数据 库 完 全 可 以 满足 微型 物 联 网 系统 的 存储 需求 。 除 了 关系 型 数据 库 
之 外 ， 键 值 对 数据 库 也 可 以 满足 系统 需求 ， 如 MongoDB。 从 开发 角度 来 看 ， 键 值 对 形式 数据 库 更 适合 Nodejs。 另 外 ，SQLite3 这 样 的 单机 版 数据 库 也 可 以 满足 微型 物 联网 系统 存储 需求 ， 而 且 使 用 过 程 也 
非常 方便 。 


2.CoAP 服 务 


通过 前 面 内 容 可 以 发 现 目 前 有 诸多 CoAP 实 现 框 架 ， 如 Python 3 的 aiocoap、Node.js 的 node-coap、Java 的 Californium。 此 处 选择 node-coap 实 现 CoAP 服 务 器 ，Python 相 对 于 Node.js 而 言 具有 更 
好 的 设备 操作 能 力 ， 在 树 莓 派 中 可 使 用 Python 控制 各 种 设备 或 传感器 ， 但 是 本 章 系统 侧重 于 CoAP 服 务 功能 ， 所 以 Node.js 略 胜 一 筹 。 


3.Web 后 端 


Web 后 端 同样 采用 Nodejjs 实 现 。 关 于 Web 开 发 Node.js 也 有 不 少 后 端 框架 ， 本 系统 选择 Express 框 架 。Express 是 一 个 基于 Nodejjs 平 台 的 极 简 、 灵 活 的 Web 应 用 开发 框架 ， 它 提供 一 系列 强大 的 特性 ， 
帮助 用 户 创建 各 种 Web 应 用 。 


4.Web 前 端 


最 近 几 年 Web 前 端 发 展 迅 猛 ， 出 现 了 很 多 新 颖 美观 的 前 端 框架 。 本 系统 选择 Bootstrap 作 为 前 端 框 架 。Bootstrap 是 最 受 欢 迎 的 HTML、CSS 和 和 Javascript 框 架 ， 可 用 于 开发 响应 式 布局 、 移 动 设备 优先 的 
Web 项 目 。 仅 使 用 Bootstrap 还 不 能 完全 满足 页 面 设计 需求 ， 还 需要 借助 Bootstrap 扩 展 插件 一 “Bootstrap-table3]。Bootstrap-table 基 于 Bootstrap 的 jQuery 表格 插件 ， 通 过 简单 设置 就 可 以 拥有 强大 的 
单 选 、 多 选 、 排 序 和 分 页 等 功能 。 


[1] https:/ /www.mysql.com/ o 
[2] http:/ /expressjs.com/ o 


[3] http:/ /bootstrap-table.wenzhixin.net.cn/ o 


94.2 ”数据 库 设计 


微型 物 联 网 系统 并 没有 用 户 权限 管理 ， 需 求 中 也 没有 指定 相应 的 角色 和 职责 ， 所 以 系统 的 数据 库 设 计 显 得 简单 得 多 。 传 感 器 的 历史 数据 仅 需 要 一 张 表 便 可 满足 存储 需求 。 数 据 库 的 名 称 为 nonitor， 传 
感 器 历史 数据 表 的 名 称 为 sensor history。 传 感 器 历史 数据 表 的 具体 内 容 见 表 9-1。 


表 9-1 传感器 历史 数据 表 设 计 


m RH 一 x om 


序号 Not | — NeNul | 主键 


8 设备 编写 
设备 编号 device id h Not Null 
ili 度 -— J 
点 ^ IN FH ) 
hà 后 IN 留 y 
光照 光照 传 感 需 
光照 light double Not Null 数 点 之 后 保留 1 位 
Jy ) 


上 报时 间 me | ^ datetime | Not |  NeNul (| 采用 数据 库 时 间 


9.4.3 CoAP API 设 计 


CoAP API 采 用 REST 风 格 ， 每 一 个 设备 均 被 定义 为 一 个 资源 ， 资 源 使 用 设备 编号 作为 唯一 标识 ， 那 么 单个 资源 采用 /devices/< device_id> 这 样 的 URI 定 义 。 请 求 负载 可 使 用 JSON 格 式 ， 把 温度 传感器 、 
湿度 传感器 、 光 照 传感器 结果 填 入 JSON 负 载 中 。CoAP API 仅 包括 一 个 上 传 传感器 检测 结果 的 接口 ， 接 口 的 具体 定义 见 表 9-2。 


表 9-2 传感器 数据 上 传 CoAP 接 口 


项 = 说 朋 
CoAP 请 求 类 型 CON 
CoAP 请 求 方法 POST 
/devices/«device 1d» 
CoAP FPK E EU 
oAP WERE Q device id 表示 设备 编号 
CoAP 请 求 媒 体 类 型 application/json 
{ 


“temp” : «temp value», 


é4 9 


hum :<hum_value>, 

WjoK f zik "light" : «li E: 

CoAP 请 求 负载 | ight light value 
j 

D temp 表示 温度 bien) 

Q hum Xm AERE fe 

Q light ME 


(£x) 
项 目 说 HH 
CoAP 啊 应 类 型 ACK 


口 2.01 Create 表示 创建 资源 成 功 
口 4.00 Bad Request 表示 创建 资源 失败 


CoAP 响应 媒体 类 型 无 
CoAP 啊 应 负载 无 


CoAP Ij fi 


9.4.4 HTTP API 设 计 


HTTP API 设 计 包括 页 面 路 由 和 数据 接口 两 部 分 ， 页 面 路 由 主要 用 于 展现 前 端 页 面 ， 并 把 从 后 端 获得 的 数据 展现 至 最 终 用 户 ; 而 数据 接口 部 分 主要 负责 把 数据 库 中 的 有 效 记 录 传 输 至 前 端 页 面 。 
1. 页 面 路 由 
(1) 根 页 面 


根 页 面 也 可 称 为 主页 面 或 默认 页 面 ， 若 用 户 访问 该 页 面 ， 服 务 器 将 泻 染 admin.html。 在 微型 物 联 网 系统 中 只 存在 一 个 动态 页 面 admin.html， 此 时 用 户 并 没有 选择 具体 设备 ， 那 么 服务 器 将 会 根据 预定 
义 规 则 选择 数据 库 中 某 台 设备 ， 如 最 新 上 传 传感器 数据 的 某 个 设备 ( 见 表 9-3) 。 


9-3 根 页 面 
项 H 说 明 
HTTP 请 求 方法 GET 
HTTP 请 求 路 由 / 
口 200 OK 表示 成 功 获 取 页 
HTTP 状态 行 天 不 成 切 获 取 页 面 
a 404 Not Found 表示 页 面 不 存在 
HTTP 啊 应 媒体 类 型 html 
HTTP 啊 应 负载 使 用 最 新 的 设备 记录 泻 染 admin.html 


(2) 指定 设备 页 面 
与 根 页 面 不 同 ， 该 页 面 路 由 中 包括 设备 编号 deviceid， 服 务 器 将 会 根据 设备 编号 渲染 admin.html ( 见 表 9-4) 。 


表 9-4 指定 设备 页 面 
项 目 说 HH 
HTTP 请 求 方法 GET 


/devices/«deviceid»/page 


HTTP 请 求 EE pp 
求 路 由 口 deviceid 设备 编号 


(5E) 
项 = 说 。 Bj 
AL TETI 
I— 下 
HTTP 啊 应 媒体 类 型 html 
HTTP 响应 负载 使 用 指定 设备 记录 ， 泻 染 admin.html 


2. 数 据 接口 


在 微型 物 联网 系统 中 ， 数 据 接口 可 提供 指定 设备 的 历史 记录 。 数 据 接口 的 路 由 为 /devices/< deviceid>/data.json， 该 路 由 和 页 面 路 由 /devices/< deviceid>/page 容 易 产 生 混淆 ，data.json 表 示 返 回 的 
结果 为 JSON 格 式 ， 而 page 表 示 返 回 一 个 HTML 页 面 。 前 端 页 面 中 表格 使 用 Bootstrap-table 组 件 ， 该 组 件 通 过 异步 的 方式 获取 数据 ， 获 取 数 据 时 可 设置 查询 条 件 ， 而 服务 器 返回 的 数据 也 应 符合 Bootstrap- 
table 的 格式 要 求 。 


当 请 求 数据 时 ， 一 般 数据 库 中 的 记录 较 多 需要 采用 分 页 的 方式 分 批 获 取 ， 可 通过 offset 参 数 和 limit 参 数 指定 选择 页 码 和 每 页 记录 数量 ， 如 每 页 显示 10 条 记录 ， 那 么 imit 的 值 为 10， 当 获取 第 一 页 记录 时 


offset=0， 当 获取 第 二 页 数据 时 offset=10， 以 此 类 推 。 


响应 数据 采用 JSON 格 式 ， 服 务 器 返回 的 JJON 对 象 中 包含 一 个 名 为 total 的 键 值 对 ，total 代 表 该 设备 传感器 记录 总 数 ，JSON 对 象 中 还 包含 一 个 名 为 rows 的 JSON 数 组 ， 该 JSJON 数 组 中 的 每 一 个 元 素 对 应 
一 条 传感器 记录 ， 而 传感器 记录 又 是 一 个 JSON 对 象 。 该 对 象 中 包括 表示 温度 传感器 、 湿 度 传感器 和 光照 传感器 的 键 值 对 。 服 务 器 将 会 根据 请 求 中 limit 参 数 返 回 指定 数量 的 传感器 记录 ( 见 表 9-5) 。 


表 9-5 ”数据 接口 


项 目 说 HH 
HTTP 请 求 方法 GET 


/devices/<deviceid>/data.json 


HTTP RH 
至 求 路 由 口 deviceid 设备 编号 


T" L] offset i 3x 4e E 
HTTP 请 求 参 数 PISS ME 
Q limit 返回 记录 最 大 数量 
u Q 200 OK 表示 成 功 获取 页 
HTTP 状态 行 a E 
CL] 404 Not Found 表示 数据 不 存在 
HTTP 啊 应 媒体 类 型 application/json 
{ 
"total": 12, 
HTTP 响应 负载 i ddl 
"ds 21. 
"device 1d": "BEIZ". 
(£X) 
项 目 说 RH 
"hum": 90, 
"temp": 24, 
"light": 182, 
"time": "2016-09-03 22:04:30" 
1 
j 9 
] 
j 


HTTP ! hy fa 37 "m" f ] TS 
站 应 负载 total: 该 设备 传感器 记录 总 数 


rows: 该 设备 传感器 记录 ， 使 用 JSON 数组 表示 
id: 记录 序号 

device id: 设备 编号 

hum: 湿度 结 

temp: 温度 结果 

light: 光照 结 

time: 传感器 上 传 数据 时 间 截 


LODDDCDCLC 


9.5 具体 实现 


完成 详细 设计 之 后 便 可 着 手 展开 具体 实现 ， 微 型 物 联网 系统 的 实现 代码 可 参考 本 书 代 码 仓库 microsystem_server 文 件 夹 ， 该 文件 夹 中 包含 以 下 内 容 : 
app.js 主 文件 用 于 初始 化 coap server 和 web server。 
* package.json 微 型 物 联网 系统 所 有 Node.js 依 赖 组 件 ， 包 括 express、swig、mysql node-coap 等 。 
: config 文 件 夹 中 包含 MySQL 连 接 信息 文件 db-config.js。 
- routes 文 件 夹 中 包含 coap_index.js 和 index.js 两 个 重要 脚本 文件 ，coap_index.js 包 含 CoAP 服 务 的 路 由 实现 ，index.js 包 括 Web 服 务 的 路 由 实现 。 


: public 文 件 夹 中 包含 Javascript、stylesheet 和 themes 三 个 文件 夹 ， 该 文件 夹 主 要 保存 和 Boosttap 有 关 的 CSS 样 式 和 Javascript 脚 本 。 


Views 文件 夹 中 包含 jayout.html 和 admin.html，layout.html 是 一 个 页 面 模板 ， 而 admin.html 继 承 了 该 模板 页 面 。 


: lib 文件 夹 中 包括 coap-toutet 组 件 ，coap-toutet 是 一 个 node-coap 的 中 间 件 ， 可 在 hode-coap 中 增加 exptess 框 架 类 似 的 路 由 处 理 功 能 。 


.test 文件 夹 包括 用 于 测试 coap 路 由 的 相关 脚本 ， 如 用 于 模拟 传感器 数据 上 传 的 post-sensof-data.js。 


微型 物 联网 系统 的 目录 结构 如 图 9-5 所 示 。 


微型 物 联网 
系统 服务 强 实 现 


9.5.1 ”数据 库 实现 


Bi app.]S 


~ : 
E package.json 


EN 
E sensor history.sql 


config 


A db-config.json 


routes 

A B . . * 
D index.]s B coap-index.js 
IM javascripts mH stylesheet 


public 
B admin.html 


A e 
D post sensor data.]S 


图 9-5 ”微型 物 联网 系统 目录 结构 


mm themes 


数据 库 是 所 有 互联 网 或 物 联 网 应 用 的 基础 。 先 在 树 莓 派 中 安装 MySQL 数 据 库 ， 然 后 在 数据 库 中 创建 表 并 在 表 中 插入 示例 数据 ， 最 后 进行 一 些 简单 的 测试 以 保证 数据 库 创建 成 功 。 


1. 安 装 MySQL 


树 莓 派 中 可 使 用 apt-get 安 装 MySQL 数 据 库 ， 在 树 莓 派 控制 台中 输入 以 下 指令 : 


# 更 新 软件 源 

sudo apt-get update 

# 安装 MySCI 数 据 库 

sudo apt-get install mysql-server 


一 般 情况 下 ，MySQL 中 存在 一 个 默认 用 户 “root”， 在 MySQL 的 安装 过 程 中 需要 为 root 用 户 设置 密码 ， 设 置 密码 的 过 程 如 图 9-6 所 示 。 


2. 创 建 数据 库 和 表 


在 MySQL 中 新 建 一 个 名 为 monitor 的 数据 库 ， 并 在 monitor 数 据 库 中 创建 名 为 sensor_history 的 数据 表 。 


(1) 登录 MySQL 控 制 台 


EP piQxukai-rpi: ~ 


Package configuration 


Configuring mysql-server-5.5 
While not mandatory, it is highly recommended that you set a password 
for the MySQL administrative "root" user. 


If this field is left blank, the password will not be changed. 


New password for the MySQL "root" user: 


图 9-6 ”为 toot 用 户 设置 密码 


+ 使 用 root 用 户 登 录 MySQL 
mysql -u root -p 

# 输 入 root 登 录 密 码 

Enter password: 


使 用 mysql 指 令 登 录 MySQL 数 据 库 ，-u 参 数 用 于 指定 有 用户， 此 处 使 用 默认 root 用 户 ，-p 代 表 用 户 登录 密码 ， 在 控制 台中 输入 “mysql-u root-p”， 按 下 回 车 键 之 后 控制 台 输出 “Enter password” 提 
示 用 户 输入 root 用 户 登录 密码 。 输 入 正确 的 登录 密码 便 可 顺利 进入 MySQL 控 制 台 。 


(2) 创建 monitor 数 据 库 


在 MySQL 控 制 台 中 通过 create datebase 指 令 创建 一 个 名 为 monitor 的 数据 库 ， 并 切换 到 monitor 数 据 库 中 。 


mysql» create database monitor; 
Query OK, 1 row affected (0.00 sec) 
mysql» use monitor; 

Database changed 


: create database monitor: 通过 create database 指 令 创 建 数据 库 ， 在 MySQL 控制 台 中 使 用 分 号 作为 命令 结束 符 。 
: use monitor: 切换 到 monitot 数 据 库 。 
(3) 创建 表 和 插入 记录 


在 microsystem_server 文 件 夹 中 包含 一 个 sensor_history.sql 脚 本 ， 该 脚本 实现 了 创建 数据 表 和 插入 示例 数据 两 个 功能 。 在 mysq| 控 制 台 中 通过 source 指 令 便 可 执行 Sensor_history.sq| 脚 本 ， 该 脚本 的 具 
体内 容 如 下 : 


代码 清单 9-1 sensor _history.sq|l 


DROP TABLE IF EXISTS 'sensor history'; 
CREATE TABLE 'sensor history' ( 

id' int(11) NOT NULL AUTO INCREMENT, 
device id' char(255) NOT NULL COMMENT ' 设 备 编 号 '， 
temp' double(11,1) NOT NULL COMMENT ' 温 度 传感器 结果 '， 
hum' double(11,1) NOT NULL COMMENT ' 湿 度 传感器 结果 '， 
light' double(11,1) NOT NULL COMMENT ' 光 照 传 感 器 结果 '， 
'time' datetime NOT NULL, 

PRIMARY KEY ('id') 

) ENGINE-InnoDB AUTO INCREMENT-4 DEFAULT CHARSET-utf8; 


NSERT INTO 'sensor history' VALUES ('1', '12CD', '18.0', '58.0', '1802.0', '2016-09-03 21: ; 
NSERT INTO 'sensor history' VALUES ('2', 'CD12', '28.0', '68.0', '2300.0', '2016-09-03 21:16:49"); 
NSERT INTO 'sensor history' VALUES ('3', 'EE12', '32.0', '70.0', '1900.0', '2016-09-03 21:1 ; 


使 用 source 指 令 时 需要 指定 sensor history.sql 脚 本 的 绝对 路 径 。 本 例 中 ，sensor history.sql 位 于 代码 仓库 the_beginning_of coap/microsystem server 目录 下 。 


source -/repo/the beginning of coap/microsystem server/sensor history.sql; 


Query OK, 0 rows affected (0.00 sec) 

Query OK, 0 rows affected (0.00 sec) 

Query OK, 0 rows affected (0.02 sec) 

Query OK, 1 row affected (0.01 sec) 

Query OK, 1 row affected (0.01 sec) 

Query OK, 1 row affected (0.01 sec) 

(4) 必要 检查 
完成 表 的 创建 之 后 需 一 些 必要 的 检查 ， 以 保证 sensor_history 表 已 经 成 功 创建 。 使 用 shows tables 指 令 可 以 查看 monitor 数 据 库 中 所 有 已 经 创建 的 表 ，MySQL 控 制 台 输 出 结果 如 下 : 


show tables; 


1 row in set (0.00 deci 


使 用 describe<table_name> 指 令 可 展现 表 的 具体 结构 ，MySQL 控 制 台 输出 结果 如 下 : 


describe sensor history; 


Field Type Null Key Default Extra 

id int (11) NO PR NUL auto increment 
device id char (255) NO NULL 

temp double (11,1) NO NUL 

hum double (11,1) NO NULL 

light double (11,1) NO NULI 

time datetime NO NUL 


6 rows in set (0.00 sec) 


通过 select 查 询 语句 可 查看 sensor_history 表 中 已 经 被 插入 的 记录 ，MySQL 控 制 台 输 出 结果 如 下 : 


select * from sensor history; 


id | device id | temp | hum light time 

1 | 12CD 18.0 | 58.0 | 1802.0 | 2016-09-03 21:14:51 
2 | CD12 28.0 | 68.0 | 2300.0 | 2016-09-03 21:16:49 
3 EE12 32.0 | 70.0 | 1900.0 | 2016-09-03 21:17:07 


3 rows in set (0.00 sec) 


到 此 ， 微 型 物 联网 系统 数据 库 的 部 分 已 经 正确 完成 。 最 后 在 控制 台中 输入 “exit” 以 退出 MySQL 控 制 台 


9.5.2 ”CoAP 路 由 实现 


COoAP 路 由 仅 包 括 一 个 /devices/</deviceid> 接 口 ， 该 接口 用 于 接收 设备 上 传 的 传感器 结果 并 将 该 内 容 插 入 sensor_history 数 据 表 中 。 


1. 启 动 CoAP Server 


在 微型 物 联网 系统 中 ，appjs 可 以 理解 为 一 个 主 脚本 ， 该 脚本 用 来 初始 化 并 启动 Web 服 务 和 CoAP 服 务 。 为 了 更 简单 地 说明 CoAP 服 务 的 创建 过 程 ， 首 先 新 建 一 个 名 为 app-coapjjs 脚 本 ， 该 脚本 中 仅 包 
括 coap 服 务 的 具体 实现 代码 ， 并 没有 Web 服 务 相关 代码 。 在 app-coap.js 中 增加 CoAP 服 务 器 实现 ， 具 体 代码 如 下 : 


代码 清单 9-2 app-coap.js 


// 模块 依赖 
var coap = require('coap'); 
// 引入 coap 路 由 


var coap routes = require('./routes/coap index'); 


var host = '0.0.0.0'; 
var coap port = 5683; 


// 启动 coap 服 务 器 
coap.createServer (coap routes).listen(coap port); 
console.log('CoAP Server Listening on :' + host + ':' + coap port); 


代码 说 明 如 下 : 

1) var coap=require ('coap') 即 载 入 node-coap 模 块 。 

2) var coap routes-require ('./routes/coap_index') 即 CoAP 路 由 的 具体 实现 位 于 coap_index.js 文 件 中 。 

3) coap.createServer (coap routes) .listen (coap port) 即 启动 CoAP 服 务 器 并 侦 听 5683 端 口 ，5683 端 口 为 CoAP 的 默认 服务 端口 。 
2. 简 单 入 手 


在 实现 微型 物 联网 系统 指定 的 CoAP 路 由 之 前 ， 先 通过 两 个 简单 的 示例 说 明 node-coap 如 何 与 MySQL “协同 工 作 ”。 本 小 节 示 例 包 括 两 个 路 由 : test 和 test-db， 在 具体 项 目 中 往往 需要 把 复杂 功能 或 未 
实践 过 的 功能 分 成 若干 个 “微小 ”的 测试 项 目 ， 通 过 一 个 又 一 个 的 简单 测试 来 推进 具体 功能 的 实现 。 


(1) test 路 由 


在 coap_indexjs 中 增加 一 个 test 路 由 实现 ， 具 体 代码 如 下 : 


// 测试 目的 路 由 

route.get('/test', function(req, res) ( 
res.code = '2.05'; 
res.end(new Date().toLocaleString()); 


]); 


test 路 由 在 第 7 章 也 曾 出 现 ， 该 路 由 可 返回 服务 器 时 间 。app-coapjjs 成 功 运行 之 后 ， 可 通过 Copper 揪 件 检 查 test 路 由 是 否 正确 返回 了 服务 器 时 间 ， 有 具体 结果 如 图 9-7 所 示 。 


(2) test-db 路 由 


在 coap_indexjjs 中 增加 一 个 test-db 路 由 ， 该 路 由 可 连接 数据 库 ， 并 执行 一 条 select 语 句 ，test-db 路 由 的 具体 实现 如 下 : 


127.0.0.1:5683 


WT 2 n NE 
2.05 Conten RTT 30 ms) nnd - — 


fisada | Sade : use hex (0x..) or string X 


Type ACK Request Options 
Code 2.05 Content 


MID 23521 
Token empty | Content-Format 


|, Payload (19) | 


. © Incoming. £j Rendered ü Outgoing | [| = | : . Blocki (Req.) Block2 (Res.)Auto 
/ | 
2016-09-25 16:13:07. €) i|| | block no. x E 


| Sizei 


total size X. size total size X. total size X size total size X 


prm 


use integer Xe 


< EE > 


-CoAP Message Log 
Time CoAP Message MID Token Options 


下 午 4:13:07 ACK-2.05 Content 23521 empty 2016-09-25 16:13:07 


图 9-7 使 用 Coppert 访 问 test 路 由 


代码 清单 9-3 ”test-db 路 由 


var coap = require ('coap'); 
var mysql = require ('mysql'); 
var config = require ('http://www.hzcourse .com/resource/readBook?path=/openresources/teach ebook/uncompressed/16571/0EBPS/Text/../config/db-config.json'); 


route.get('/test-db', function (req, res) { 
var conn = mysql.createConnection (config); 
conn.connect () ; 


conn.query('SELECT 1+2 AS result', 
function (err, rows) { 


var result = rows[0].result; 
res.code = '2.04'; 


res.setOption('Content-Format', 'application/json'); 
res.end(JSON.stringify((result: result])); 


}); 


conn.end(); 


代码 说 明 如 下 : 
1) var mysql=require ('mysql') : 引入 MySQL 依 赖 组 件 。 


2) var config=require ('http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/16571/OEBPS/Text/../config/db-config.json') : 引入 数据 库 连 
接 配 置 文件 db-config.json，db-config.json 包 括 用 户 名 、 密 码 和 数据 库 名 称 等 信息 ， 具 体内 容 如 下 : 


"host": "localhost", 
"user": "root", 
ur E "123456", 
"database": "monitor", 
"dateStrings": true 


3) var conn2 mysql.createConnection (config) : 创建 一 个 MySQL 数据库 连接 。 


4) conn.connect () : 打开 MySQl 数据库 连接 。 


5) conn.query ('SELECT 1+2 AS result', function (err, rows) {H : 执行 SQL 查询 语句 ， 使 用 result 作 为 查询 结果 别名 ， 该 SQL 其 实 让 MySQL 执 行 一 次 加 法 操作 并 把 结果 保存 在 result 中 ， 可 以 预 
见 result=3。 


6) res.code='2.04': 设置 CoAP 响 应 码 为 2.04， 表 示 CoAP 正 确 请 求 ，2.04 和 HTTP 200 OK 具有 相同 的 语义 。 

7) res.setOption ('Content-Format', 'application/json') : 设置 响应 媒体 类 型 ， 此 处 为 JSON 格 式 。 

8) resend (JSON.stringify ((result: result)) ) : 构造 CoAP 响 应 ， 把 result 组 装 为 JSON 格 式 并 通过 res.end 反 馈 至 CoAP 客 户 端 。 
9) conn.end () : 关闭 MySQL 数 据 库 连 接 。 


使 用 Copper 揪 件 访问 test-db 路 由 ， 访 问 test-db 路 由 之 后 可 以 在 Incoming 选 项 卡 中 观察 到 {"result" : 3}， 具 体 结果 如 图 9-8 所 示 。 


3. 传 感 器 路 由 实现 
在 9.4.3 节 中 已 经 详细 定义 了 传感器 数据 上 传 路 由 ， 传 感 器 数据 上 传 使 用 CoAP POSTHA, 请 求 URI 中 指定 设备 编号 ; 请 求 负载 中 以 JSON 格 式 保存 温度 、 湿 度 和 光照 结果 。CoAP 服 务 器 接收 到 该 请 求 之 


后 ， 把 三 种 传感器 结果 插入 sensor_history 数 据 表 中 ， 具 体 实现 代码 如 下 : 


代码 清单 9-4 ”传感器 路 由 实现 


route.post('/devices/(device id}', function (req, res) { 


var device id = req.params.device id; 
console.log('device id: $s', device id); 


var payload = JSON.parse (req.payloaqg); 
var temp = payload.temp; 

var hum = payload.hum; 

var light = payload.light; 


var conn = mysql.createConnection (config); 
conn.connect () ; 


conn.query('INSERT INTO sensor history SET device id-?, temp-?, hum-?, light-?, time-NOW()', 
[device id, temp, hum, light], 
function (err, rows) { 
if (err) { 
console.log ("client error: " + err.message); 
res.code = 4.00; 
res.end(); 
} else { 
res.code = '2.01'; 
res.end(); 


}); 


conn.end(function(err) { 
console.log('db close'); 


F)? 


127.0.0.1:5683 


ls 


(€) © | coap;//127.0.0.1/test-db 


* 
` 


Ping a Discover e GET > POST + PUT 
Y f e ontro 
2.05 Content (RTT 17 ms) DD pg Control ret 


Header | Value Option D N use hex (Üx..) or string X 


Type ACK Content-Format application/json Request Options 


Code 2.05 Content 
MID 34291 


Token empty Content-Format 


Payload (12) | 


| incoming |E Rendered] 6 Outgoing) — (| 7 | | Block (Req) Block? (Res)Auto 
| | [heana x z 


result 3] 9 | a 


total size X| | total size X 


Observe 


use integer K| y 
> 


CoAP Message Log 
Time CoAP Message MID Token Options 


下 午 4:39:33 ACK-2.05 Content 34291 empty Content-Format: 50 


图 9-8 使 用 Coppet 访 问 testdb 路 由 


代码 说 明 如 下 : 

1) route.post ("/devices/(device id)", function (req, res) (0) : 传感器 数据 上 传 路 由 ，{device_id} 表 示 传 感 器 编号 ， 传 感 器 编号 以 字符 串 变 量 的 形式 存在 于 URI 中 ， 该 POST 路 由 将 会 处 理 所 有 
以 /devices/ 开 头 的 路 由 ， 如 /devices12CD、/devices/EF12， 其 中 12CD 和 EF12 均 为 设备 编号 。 

2) var device id=red.params.device id: 获取 请 求 URI 中 的 device id 变量 ， 该 变量 位 于 red.params 对 象 中 。 

3) var payload=JSON.parse (req.payload) : 通过 JSON.parse 把 请 求 负载 转化 为 JJON 对 象 ， 通 过 payload.hum 这 样 的 方式 便 可 获得 湿度 传感器 结果 。 

4) INSERT INTO sensor history SET device id=?, temp=?, hum=?, light=?, time=NOW () : SQL 插入 语句 ， 把 设备 编号 、 传 感 器 温度 、 传 感 器 湿度 、 传 感 器 光照 和 当前 时 间 插 入 
sensor_history 数 据 表 中 。 


5) conn.query ('INSERT INTO SET device idz?, http://www.hzcourse.com/resource/readBook?path 2/openresources/teach ebook/uncompressed/16571/OEBPS/Text/..', [device id, 
..], function () 0) : 在 SQL 插入 语句 中 使 用 “?” 作 为 占 位 符 。 


6) res.code='2.01'; res.end () : 若 数 据 插入 操作 成 功 ，CoAP 响 应 码 设置 为 2.01， 表 示 资 源 创 建成 功 ， 最 后 调用 res.end () 向 CoAP 客 户 端 返回 响应 。 

4. 动 手 测试 

完成 传感器 路 由 之 后 可 动手 测试 该 路 由 是 否 工 作 正 常 ， 在 多 数 软件 系统 中 “做 一 步 测 一 步 ” 是 一 种 比较 良好 的 开发 习惯 。 为 了 测试 传感器 路 由 ， 此 处 编写 一 个 coap 客 户 端 模拟 传感器 设备 ， 由 于 没有 真 
实 的 传感器 设备 ， 此 处 使 用 一 定 范围 内 随机 数 蔡 代 传感器 检测 结果 ， 一 定 范围 的 随机 数 可 通过 min+ (max-min) *Math.random () 计算 得 到 ， 此 时 min 模 拟 传 感 器 的 最 小 检测 结果 ，max 代 表 模 拟 传 感 器 
的 最 大 检测 结果 。 

在 test 文 件 夹 中 新 建 一 个 名 为 post-sensor-datajjs 的 脚本 ， 脚 本 的 具体 内 容 如 下 : 


代码 清单 9-5  post-sensor-data.js 


const coap = require('coap!) 


// var host = 'localhost' 
var host = «raspberry ip address» 
var device id = '12CD' 


var temp = Math.round(10 + (20 - 10) * Math.random()); 

var hum = Math.round(60 + (90 - 60) * Math.random()); 

var light = Math.round(2000 + (3000 - 2000) * Math.random()); 
console.log('temp, hum, light', temp, hum, light); 


var pathname - 'devices/' * device ig; 
var req = coap.request ({ 

host: host, 

pathname: pathname, 

method: 'POST' 


req.setOption ("Content-Format", "application/json"); 


var payload = { 
temp: temp, 
hum: hum, 
light: light 


req.write (JSON.stringify (payload)); 


req.on(' response' , function (res) ( 
console.log('response code: ' + res.code) 
console.log('response payload: ' + res.payloag) 


req.end() 


代码 说 明 如 下 : 


1) var temp=Math.round (10+ (20-10) *Math.random () ) : 模拟 一 个 温度 传感器 结果 ， 温 度 传感器 采用 一 个 随机 整数 表示 ， 最 小 结果 为 10， 最 大 结果 为 20。 湿 度 传感器 和 光照 传感器 采用 相 
同 的 模拟 方法 。 


2) var device id='12CD'; var pathname='devices/'+device id: 构造 CoAP URI-PATH， 模 拟 请 求 的 设备 编号 为 12CD。 

3) var req=coap.request ({host: host, pathname: pathname, method: 'POST'}) : 构造 CoAP 请 求 ， 其 中 host 需 使 用 树 莓 派 的 具体 |P 地 址 蔡 换 ， 此 处 请 求 方法 为 CoAP POST 方法 。 
4) req.setOption ("Content-Format", "application/json") : 设置 CoAP 请 求 负载 媒体 类 型 ， 此 处 为 application/json 格 式 。 

5) var payload- (temp: temp, hum: hum, light: light): 构造 CoAP 请 求 负载 ， 请 求 负 载 中 包括 温度 、 湿 度 和 光照 结果 。 

6) req.write (JSON.stringify (payload) ) : 使 用 JSON.stringify 函 数 把 JavasScript 转 换 为 符合 JSON 标 准 的 字符 串 ， 并 把 该 字符 串 写 入 CoAP 负 载 中 。 

7) req.end () : 通过 UDP 发 送 CoAP 请 求 。 


在 树 莓 派 中 运行 app-coapjs， 在 控制 台中 输入 : 


# 通过 npm 安 装 node-coap 
npm install node-coap 
# 启动 CoAP 服 务 器 


node app-coap.js 


在 其 他 主机 中 运行 post-sensor-data.js， 在 控制 台中 输入 : 


# 通过 npm 安 装 node-coap 
npm install node-coap 

# 启动 CoAP 客 户 端 

node post-sensor-data.js 


最 后 重新 登录 MySQL 数 据 库 ， 查 看 数据 是 否 正确 插入 。 


+ 登录 mysql 

mysql -u root -p 

Enter password: 

Welcome to the MySQL monitor. 
# 选择 monitor 数 据 库 

mysql» use monitor; 

# 查看 sensor history 的 所 有 记录 


mysql> select * from sensor history; 
y e y 


id | device id | temp hum ight time 
1 12CD 18.0 58.0 1802.0 2016-09-03 21:14:51 
2 CD12 28.0 68.0 2300.0 2016-09-03 21:16:49 
3 EE12 32.0 70.0 1900.0 2016-09-03 21:17:07 
4 12CD 14.0 79.0 2282.0 2016-10-02 12:08:40 


4 rows in set (0.00 sec) 


此 时 sensor_history 表 中 增加 了 一 条 记录 ， 温 度 传感器 的 模拟 记录 为 14， 湿 度 传感器 的 模拟 记录 为 79， 而 光照 传感器 的 模拟 记录 为 2282。 通 过 该 测试 可 以 说 明 传 感 器 路 由 已 经 被 正确 实现 ,一 旦 CoAP 
服务 器 接收 到 传感器 数据 ， 那 么 这 些 数据 将 被 正确 地 插入 sensor_history 表 中 。 


9.5.3 Web 前 端 实现 


Web 前 端 主要 由 两 个 HTML 文 件 组 成 : layout.html 和 和 admin.html，layout.html 是 一 个 模板 文件 ， 该 HTML 中 主要 用 于 引入 CSS 样 式 和 JavaScript 脚 本 ， 该 文件 中 并 没有 具体 内 容 。admin.html 继 承 
layout.html， 这 样 就 不 必 重 复 引 入 各 种 CSs 样 式 和 Javascript 脚 本 ， 和 layout.html 不 同 ，admin.htmIl 将 向 用 户 展现 动态 数据 。 本 例 中 Web 前 端 使 用 Bootstrap 框 架 ， 另 外 还 使 用 基于 Bootstrap 的 扩展 组 件 
一 一 Bootstrap-table， 该 组 件 是 一 个 简单 实用 的 网 页 版 “datagrid 控 件 ”。 


layout.html 和 admin.html 均 位 于 views 文 件 夹 中 ，layout.html 和 admin.html 部 分 的 编写 工作 除了 与 CSS 样 式 、HTML 元 素 和 JavaScript 脚 本 有 关 之 外 ， 还 与 Web 后 台 使 用 的 模板 泻 染 引 擎 相关 。 本 例 
中 Web 后 台 使 用 Express 框 架 ， 而 Express 框 架 的 默认 模板 引擎 为 ade， 但 本 例 使 用 了 另 一 种 模板 引擎 swig， 它 和 Python Web 开 发 中 常用 的 Jinja 模 板 引擎 非常 相似 。 


1.layout.html 
layout.html 具 体 实 现代 码 如 下 : 


代码 清单 9-6 layout.html 


«!DOCTYPE html» 
«html» 
($ block heads} 
«head» 
«meta charset-"utf-8"» 
«title»($ block title $)title($ endblock $)«/title» 


($ block meta %} 
«meta name-"viewport" content-"width-device-width, initial-scale-1, maximum-scale-1, user-scalable-no"» 
($ endblock %$} 


($ block styles $) 

<link rel="stylesheet" href-"/stylesheet/custom.css"» 

<link rel="stylesheet" href="/stylesheet/bootstrap.css"> 

<link rel="stylesheet" href="/stylesheet/bootstrap-theme.css"> 
<link rel="stylesheet" href="/stylesheet/bootstrap-table.min.css"> 


{5 endblock %} 


($ block scripts %} 
«script type-"text/javascript" src-"/javascripts/jquery.min.js"»«/script» 
«script type-"text/javascript" src-"/javascripts/bootstrap.min.js"»«/script» 


eror cete 


«script type-"text/javascript" src-"/javascripts/bootstrap-table.min.js"»«/script» 
«script type-"text/javascript" src-"/javascripts/bootstrap-table-zh-CN.min.js"»«/script» 
($ endblock $] 

</head> 


($ endblock 5%} 


<body> 
($ block content %} 
($ endblock 5%} 
</body> 
</html> 


layout.html 部 分 说 明 如 下 : 


1) (96block head%}H%endblock%}: 使 用 swig 模 板 中 的 block 定 义 一 个 “ 块 ”， 其 他 html 文 件 若 继 承 layout.html 即 可 直接 使 用 block 定 义 的 内 容 ， 也 可 以 重新 定义 或 追加 block 中 所 包含 的 内 容 。 例 如 
layout.html 中 定义 “{%block title%}title{%endblock%}”， 若 admin.htm| 没 有 重新 定义 title block， 那 么 admin.html 的 网 页 标题 为 “title”; 若 在 admin.html 定 义 “{%block title%} 微 型 物 联 网 系统 
{%endblock%}”， 那 么 admin.html 的 网 页 标题 为 “微型 物 联网 系统 ”。 


2) layout.html 中 还 引入 了 Bootstrap 框 架 相关 的 样式 和 主题 ， 也 引入 了 Bootstrap-table 相 关 的 样式 和 脚本 。 
3) admin.html 需 要 在 body block 中 填 入 具体 的 内 容 。 
2.admin.html 


admin.html 主 要 由 两 部 分 组 成 ， 即 左 侧 设备 列表 和 右 侧 数 据 表格 ， 在 Bootstrap 框 架 中 页 面 宽 度 方向 被 分 为 12 列 ， 在 本 例 中 设备 列表 占据 2 列 ， 使 用 col-sm-2 样 式 定义 ; 而 右 侧 数 据 表 格 占 10 列 ， 使 用 
col-sm-10 样 式 定 义 。 在 右 侧 数据 表格 中 又 可 分 为 路 径 导 航 和 Bootstap-table 两 部 分 ， 路 径 导 航 位 于 Bootstrap-table 的 上 方 。admin.htm| 最 终 外 观 如 图 9-9 所 示 。 


€ > C |© 192.168.0.6:8090/devices/EE12/page 


2016-09-03 21:17:07 


«div class="col-sm-10"> 
«ol class="breadcrumb"> 
«/ol 


«table id="table"> 
</table> 


<div class-"col-sm-2"» «[div» 
«div class-"list-group" 
«div» 
«div» 


显示 第 1 到 第 1 条 记录 ， 总共 1 条 记录 


图 9-9 ”admin.html 外 观 


admin.htm| 的 具体 实现 代码 如 下 : 


代码 清单 9-7 admin.html 


($ extends 'layout.html' $) 


($ block title$] 


微型 物 联 网 系统 
($ endblock %} 


($ block content % 
«div class-"container"» 


«div class-"row"» 
«div class-"col-sm-2"» 
«div class-"list-group"» 
«a href="#" class-"list-group-item active"> 设 备 列表 </a> 
($ for item in devices %} 
«a href-"/devices/[([item.device id)]/page" class-"list-group-item"» 
((item.device id}} 


«/a» 
$ endfor $2) 
«/div» 


«/div» 
«div class-"col-sm-10"» 
«ol class-"breadcrumb"- 
<1i> 设 备 </1i> 
«li class="active">{ {device id}}</li> 
</ol> É 
«table id-"table" 
data-toggle-"table" 
data-url-"í(url]))" 
data-height-"500" 
data-side-pagination-"server" 
data-pagination-"true" 
data-page-list-"[5, 10, 20]" 
data-search-"false" 
data-query-params-"query params"» 
«thead» 
«tr» 


data- 
data- 


ield-"id" data-formatter-"formatter id"> 序 号 </th> 
ield-"device id"> 设 备 编号 </th> 


Li jt ) | y ) 


«th 
«th 
«th data-field="temp"> 温 度 </th> 
«th data-field="hum"> 湿 度 </th> 
«th data-field="light"> 光 照 </th> 
«th data-field="time"> 时 间 </th> 
</tr> 
«/thead» 
«/table» 
«/div» 
«/div» 
«/div» 


«script type-"text/javascript"» 


Function formatter id(value, row, index) { 
return index + 1; 


} 


function query params (params) { 
return {limit: params.limit, offset: params.offset} 


} 


$(function () { 
console.log('ready!'); 


D; 
</script> 


{5 endblock 5%} 


admin.html 代 码 解释 如 下 : 
1) (96extends'layout.html'?59: admin.html 继 承 layout.html 模 板 。 
2) {%block title%)} 微 型 物 联网 系统 {%endblock%}: 重新 定义 网 页 标题 ， 改 为 微型 物 联网 系统 。 


3) 使 用 Bootstrap 中 列表 组 显示 设备 列表 ， 设 备 列 表 的 具体 数据 由 后 台 提 供 ， 后 台 向 swig 模 板 引 警 传 入 一 个 名 为 devices 的 对 象 ，devices 对 象 中 使 用 数组 的 形式 保存 所 有 设备 的 device_id，swig 模 板 引 
掌 通 过 一 次 循环 把 device_id “格式 化 ”为 list-group-item 样 式 。 在 swig 模 板 引擎 中 ，if 和 for 这 样 的 关键 字 使 用 {%%} 标 签 包 里 ， 如 {%for item in devices?6); 而 变量 使 用 从 }) 包 里 ， 如 {fitem.device_id}}。 


«div class-"list-group"» 
«a href="#" class-"list-group-item active"> 设 备 列表 </a> 
$ for item in devices %} 
«a href-"/devices/[(item.device id))/page" class-"list-group-item"» 
((item.device id]] i 


</a> 
% endfor %} 
</div> 


4) 路 径 导 航 可 帮助 用 户 获知 当前 查看 的 设备 编号 。 


«ol class-"breadcrumb"» 

«li»W&«/li» 

«li class-"active"»[([device id))«/li» 
«/ol» 


5) data-url-"((url" : 设置 Bootstrap-table 从 服务 器 获取 数据 的 路 径 ， 数 据 路 径 由 服务 器 泻 染 ， 变 量 名 称 为 {ur|}。 
6) data-side-pagination= "server": Bootstrap-table 可 使 用 前 端 分 页 或 后 端 分 页 ， 此 处 设置 为 后 端 分 页 。 


7) data-query-params-"query params": 由 于 Bootstrap 采 用 后 端 分 页 ， 所 以 需要 设置 查询 参数 ，Bootstrap-table 向 后 端 请 求 数据 前 将 运行 query_params 函 数 。 


function query params (params) { 
return {limit: params.limit, offset: params.offset} 


} 


Bootstrap 的 默认 查询 参数 有 很 多 ， 但 本 例 中 仅 使 用 了 limit 参 数 和 offset 参 数 ，limit 参 数 表示 单个 分 页 包含 多 少 个 记录 ， 而 offset 表 示 记 录 的 偏 移 量 ，offset 参 数 和 页 码 的 含义 非常 类 似 。 


8) 定义 表 头 ， 表 头 中 data-field 属 性 值 应 与 数据 库 sensor_history 表 的 字段 名 称 保持 严格 一 致 ， 如 <th data-field="temp"> 温 度 </th> 中 ，data-field="temp" 说 明 该 列 显 示 所 有 的 温度 传感器 结果 。 


«tr» 
«th data-field-"id" data-formatter-"formatter idq"> 序 号 </th> 
«th data-field-"device id"> 设 备 编号 </th> i 
«th data-field="temp"> 温 度 </th> 
«th data-field-"hum"»i HEP «/th» 
«th data-field="light"> 光 照 </th> 
«th data-fielgd="time"> 时 间 </th> 
</tr> 


9) Bootstrap-table 中 还 可 以 显示 单元 格 实现 内 容 ， 表 格 中 的 序号 列 并 没有 采用 sensor_history 中 的 id 字段 ， 而 使 用 了 表格 中 的 行 编号 ，Bootstrap-table 的 行 编号 从 0 开始 ， 而 实际 使 用 时 行 编号 应 从 1 
开始 。 


return index + 1; 


} 


Function formatter id(value, row, index) { 


10) $ (function () {console.log ('ready! ') ; }) : 用 于 检查 jQuery 是 否 载 入 成 功 。 如 果 jQuery 载 入 成 功 ， 可 在 浏览 器 控制 台中 观察 到 “ready! " , 


9.5.4 Web 后 端 实现 


Web 后 端 使 用 Express 框 架 实现 ，Web 后 端 包含 有 两 个 功能 。 第 一 ， 根 据 用 户 的 请 求 动态 泻 染 admin.htmlI 页 面 ; 第 二 ， 浏 览 器 载 入 admin.html 后 ，Bootstrap-table 将 根据 data-url 属 性 向 后 端 请 求 表 
格 数据 ， 后 端 需要 根据 Bootstrap-table 的 预定 义 格式 提供 JSON 数 据 。 


1. 启 动 HTTP Server 


app.js 负 责 启动 HTTP 服 务 和 CoAP 服 务 ， 在 CoAP 路 由 实现 小 节 中 app-coap.js 已 经 完成 了 启动 CoAP 服 务 的 相关 代码 ，app.js 需 要 在 此 基础 上 增加 HTTP 服 务 的 实现 代码 。app.js 的 具体 实现 代码 如 下 : 


代码 清单 9-8  appjs 


// 模块 依赖 


var express = require('express') 


var bodyParser = require('body-parser') 


var path = require('path') 


var swig = require('swig 


var coap = require('coap 


var routes = require('./routes/index'); 


') 
") 


var coap routes = require('./routes/coap index'); 


var app = express (); 


// 设置 泻 染 引擎 


app.engine('html', swig.renderFile); 


app.set('view engine', 'html'); 


app.use (bodyParser.json()); 
app.use (express.static (pal 


var coap port = 5683; 


var port 8090; 


var host = '0.0.0.0'; 


app.use('/', routes); 


// 启动 http 服 务 器 


app.listen(port, host); 
console.log('Http Server Listening on 


// 启动 coap 服 务 器 


coap.createServer (coap routes).listen(coap port); 
:' + host ':' + coap port); 


console.log('CoAP Server Listening on 


th.join( dirname, 'public'))); 


:" + host + 'i! + port); 


1) var express=require ('express') : 增加 express 依 赖 项 。 


2) var routes-require ('/routes/index) : 引入 所 有 的 Web 路 由 ， 这 些 路 由 在 routes 文 件 夹 中 的 index.js 脚 本 文件 中 实现 。 


`. 


3) app.engine ('html', swig.renderFile) app.set ('view engine', 'html') : 设置 泻 染 引 警 ， 本 例 采 用 swig 模 板 引 警 ， 所 有 扩展 名 为 htm| 的 文件 将 使 用 swig 模 板 引擎 进 行 演 染 . 


4) app.use (express.static (path.join (_dirname, 'public') ) ) : 指定 相关 静态 文件 路 径 ， 这 些 文件 包括 CSS 样 式 和 JavaScript 脚 本 ， 这 些 文件 都 保存 在 public 文 件 夹 中 。 此 处 相关 CSS 样 式 和 
JavaScript 脚 本 的 根 目 录 为 public， 其 路 径 总 是 相对 于 public 文 件 夹 ， 如 <script src="/javascripts/jquery.min.js"> </script>. 


5) app.use ('/', routes) Express 框 架 接收 到 的 所 有 用 户 请 求 均 由 routes 进 行 处 理 ，routes 指 向 routes 文 件 夹 内 的 index.js 文 件 。 


6) app.listen (port, 


2. 设 备 路 由 


host) : 在 指定 端口 


启动 HTTP 服 务 。 


设备 路 由 需要 实现 两 部 分 功能 : 第 一 ， 若 用 户 没 有 选择 设备 编号 ， 那 么 服务 器 返回 用 户 默认 设备 的 历史 数据 ; 第 二 ， 若 用 户 选 择 单个 设备 ， 那 么 服务 器 返回 具体 设备 的 历史 数据 。 在 /routes/index.js 文 


件 中 增加 一 个 获取 所 有 设备 


编号 的 函数 


function get device list (callback) { 


get device list: 


var conn = mysql.createConnection (config); 


conn.connect(); 


conn.query ("SELECT DISTINCT device id FROM sensor history", 


function (err, rows) { 


callback 


]); 


conn.end(); 


(rows); 


get_device_list 国 数 的 具体 说 明 如 下 : 


1) SELECT DISTINCT device id FROM sensor history: 使 用 DISTINCT 关 键 字 查询 所 有 不 重复 的 device_id， 该 条 SQL 语 句 将 返回 sensor_history 中 所 有 不 重复 的 设备 编号 。 


2) callback (rows) : 通过 回调 的 方式 返回 所 有 记录 。 


设备 路 由 可 处 理 两 类 路 由 ， 即 “/” 和 "/devices/: device id/page”， 在 index.js 中 通过 以 下 代码 实现 路 由 处 理 。 


router.get('/', function (req, res) { 


get device list (í 


function (rows) { 


var device id = rows[0].device id 


var url = '/devices/' 


t device id + '/data.json'; 


res.render('admin.html', (url: url, device id: device id, devices: rows]); 


}) 
]):; 


router.get ('/devices/:device id/page', 


var device id = req.params.device id; 


Function (req, res) ( 


var url = '/devices/' + device id 


ger device list (í 


function (rows) { 


F'/data.json'; 


 res.render('admin.html', (url: url, device id: device id, devices: rows]); 


}) 
EF 


这 两 个 路 由 非常 相似 ， 处 理 “/” 路 由 时 ，device id 采用 查询 结果 的 第 一 条 记录 ; TURN "/devices/: device id/page" Af, device id 已 经 由 用 户 在 URL 中 定义 。 具 体 代 码 说 明 如 下 : 


1) get device list (function (rows) (http://www.hzcourse.com/resource/readBook?pathz/openresources/teach ebook/uncompressed/16571/OEBPS/Text/..)) : 调用 get device list 获 
取 所 有 不 重复 的 设备 记录 ， 在 调用 get_device list 通 过 匿名 回调 函数 获取 结果 。 


2) var url='/devices/'+device id+'/data.json': 向 前 端 Bootstrap-table 传 入 获取 表格 数据 的 URL， 如 “device id” 为 CD12， 那 么 获取 表格 数据 的 URL 为 “/devices/CD12/data.json”。 


3) res.render ('admin.html', (url: url, device id: device id, devices: rows}) : 使 用 url、device id 和 devices 人 参数 演 染 admin.html， 其 中 url 和 device id 可 理解 为 单个 变量 ， 而 devices 为 设备 


编号 的 集合 包含 多 个 结果 。 
3. 传 感 器 数据 接口 


传感器 数据 接口 是 一 个 返回 JSON 格 式 数据 的 异步 接口 ， 该 接口 专门 为 Bootstrap-table 服 务 。 


router.get('/devices/:device id/data.json', function (req, res) { 
var device id = req.params.device id; 

var offset = parseInt(req.query.offset) || 0; 

var limit = parseInt(req.query.limit) || 10; 

var total = 0; 

var rows - null; 


var conn = mysql.createConnection (config); 
conn.connect () ; 


conn.query('SELECT COUNT(*) as total FROM sensor history WHERE device id-?', 
[device id], 
function (err, result) { 

total = result[0].total; 


PI 


conn.query('SELECT * FROM sensor history WHERE device id=? order by id desc limit ?, ?', 
[device id, offset, limit], 
function (err, result) { 

rows = result; 


D 


conn.end (function (err) { 
res.json((total:total, rows:rows}); 
Joys 
); 


该 部 分 代码 说 明 如 下 : 
1) var device id=req.params.device id: 通过 req.params 获 取 “URL” 中 的 device id 变量 。 
2) var offset=parselnt (req.query.offset) ||0; var limit=parselnt (req.query.limit) ||10: 通过 red.query 获 取 请 求 参 数 offset 和 limit， 其 中 offset 的 默认 值 为 0， 而 limit 的 默认 值 为 10。 


3) SELECT COUNT (*) as total FROM sensor history WHERE device id=?: 通过 COUNT (*) 和 WHERE 关键 字 查 询 指定 device_ id 的 传感器 历史 数据 记录 总 数 。 


4) SELECT*FROM sensor history WHERE device id=?order by id desc limit?, ?: 使 用 limit 关 键 字 限制 查询 结果 的 数量 ， 通 过 JSON 数 组 的 方式 向 查询 语句 传递 三 个 参数 
limit， 其 中 offset 参 数 可 指定 查询 结果 初始 位 置 ， 而 limit 参 数 可 指定 查询 结果 数量 。 


device id、offset、 


5) resjson ((total: total, rows: rows}) : 当 两 次 查询 动作 完成 之 后 通过 res.json 返 回 JSON 结 果 。res.json 是 一 个 返回 JSON 媒 体 类 型 的 简便 方法 ， 该 函数 将 自动 填充 HTTP 首 部 并 把 JavaScript 对 象 
转化 为 JSJON 字 符 串 。 


4. 动 手 测试 
完成 设备 路 由 和 传感器 数据 接口 之 后 ， 可 进行 一 些 简 单 的 测试 以 保证 这 些 接口 工作 正常 。 在 9.5.1 节 ， 创 建 snsor_history 表 时 已 经 在 表 中 插入 了 三 条 记录 ， 三 条 记录 分 别 属于 不 同 的 设备 编号 一 一 
12CD、CD12 和 EF12， 那 么 访问 /devices/12CD/data.json 至 少 可 以 获得 一 条 记录 。 


在 树 莓 派 控制 台中 运行 appjs: 


# 运行 所 有 服务 器 

node app.js 

# 控制 台 打 印 

Http Server Listening on :0.0.0.0:8090 
CoAP Server Listening on :0.0.0.0:5683 


在 浏览 器 地 址 栏 内 输入 http://<raspberry_ip> : 8090/devices/12CD/data.json， 若 传感器 数据 接口 工作 正常 ， 可 在 浏览 器 中 可 观察 到 如 图 9-10 所 示 输 出 。 


[A 192.168.0.6:8090/devi- X 


{" total”: 18, "rows": 

[{"id”:20, "device id" :"12CD^, "temp" :17, hum :85, "light" :2746, "time" :”2016-10-03 12:39:02”}, 

l'id':19, "device id : 12CD "temp" :18, "hum" :83, "light" :2380, "time": "2016-10-03 12:39:00^j, 
:18, "device id : 12CD', "temp :18, "hum :88, "light :2395, "time": 2016-10-03 12:38:58^j, 


:17, "device id" : “12CD "temp" :18, "hum" : 72, "light" :2117, "time": "2016-10-03 12:38:56"), 
:16, "device id :"12CD', "temp" :20, "hum :64, "light" :2143, "time": "2016-10-03 12:38:54", 
:15, "device id :"12CD^, "temp" :12, "hum" :67, "light" :2945, "time": "2016-10-03 12:38:52"), 
:14, "device id": 12CD', "temp" :1l, "hum": 74, "light" :2668, "time": "2016-10-03 12:38:50^j, 
:13, "device id :"12CD^, "temp" :11, "hum" :85, "light" :2438, "time": "2016-10-03 12:38:48"), 
:12, "device id':"12CD', "temp" :20, "hum" :63, "light" :2047, "time" : 2016-10-03 12:38:46”}, 
:ll, "device id : “12CD "temp" :13, hum :76, "light" :2458, "time": "2016-10-03 12:38:44”}]} 


图 9-10 访问 传感器 数据 接口 


9.6 ERAMA 


下 面 我 们 为 微型 物 联网 系统 做 一 轮 综 合 测试 ， 通 过 综合 测试 验证 功能 是 否 符合 设计 需求 。 


9.6.1 ”启动 微型 物 联网 系统 


在 树 莓 派 启动 Web 服 务 器 和 CoAP 服 务 器 ， 在 控制 台中 输入 以 下 指令 : 


# 局 动 Wep 服 务 器 和 CoAP 服 务 器 
JS 


node app. 
# 


Http Server Listening on :0.0.0.0:8090 
CoAP Server Listening on :0.0.0.0:5683 


9.6.2. ”增加 蛋 拟 数据 


为 了 更 好 地 测试 微型 物 联网 系统 ， 可 以 通过 test 文 件 夹 中 的 post_ sensor data.js 脚 本 向 CoAP 服 务 器 插入 更 多 的 模拟 数据 。 


9.6.3 ”访问 默认 设备 


在 浏览 器 地 址 栏 中 输入 树 莓 派 的 I|P 地 址 和 服务 端口 号 ， 此 处 树 莓 派 的 IP 地 址 为 192.168.0.6， 服 务 端口 号 为 8090， 在 浏览 器 中 输入 “192.168.0.6: 8090" ， 具 体 结果 如 图 9-11 所 示 。 


D 微型 物 联 网 系统 x 
€ > Q3 |© 192.168.0.6:8090 


m |Ì pr 时 间 


RERS 湿度 

a200 LT 9 2746 | 2016-10-03 12:39:02 
cD am 2380 | 2016-10-03 12:39:00 
("aD em 2395 | 2016-10-03 12:38:58 


12CD "s mo 2117 2016-10-03 12:38:56 
12CD 2 9 2143 2016-10-03 12:38:54 


12CD 67 2945 2016-10-03 12:38:52 

12CD 74 2668 | 2016-10-03 12:38:50 

(wo |n [m |a 2005248 

9 ("D — 2 8 2047 2016-10-03 12:38:46 
716 2458 


10 12CD 13 2016-10-03 12:38:44 


显示 第 1 到 第 10 条 记录 , MAar smen e. | 条 2 录 | Meo 


图 9-11 访问 默认 设备 


虽然 在 URL 中 并 没有 指定 设备 编号 ， 但 是 HTTP 服 务 器 依然 返回 了 默认 设备 12CD 的 部 分 历史 记录 。 


9.6.4 ”使 用 分 页 功能 


由 于 12CD 设 备 的 传感器 记录 较 多 ， 所 以 Bootstrap-table 采 用 分 页 显示 的 方式 展现 历史 记录 ， 默 认 情 况 下 每 页 显示 10 条 记录 ， 用 户 可 选择 网 页 右 下 角 的 页 码 查看 其 他 历史 记录 ， 分 页 查询 结果 如 图 9-12 
所 示 。 


[y 微型 物 联网 系统 
€ > Œ |© 192.168.0.6:8090 


2044 2016-10-03 12:38:43 


2602 2016-10-03 12:38:41 


2016-10-03 12:38:39 


2016-10-03 12:38:36 


85 2016-10-03 12:38:35 


84 2016-10-03 12:38:32 


2502 
FH 2282 2016-10-02 12:08:40 
802 2016-09-03 21:14:51 


显示 第 11 到 第 18 条 记录 ， 总 共 18 条 记录 每 页 显示 条 记录 


图 9-12 ”使 用 分 页 功能 


9.6.5 ”访问 其 他 设备 


选择 左 侧 的 设备 列表 中 的 其 他 项 可 查看 其 他 设备 的 历史 记录 ， 假 如 选择 CD12 设 备 ， 那 么 页 面 将 会 跳 转 至 /devices/CD12/page。 跳 转 之 后 的 结果 如 图 9-13 所 示 。 


LE IET 时 间 


2016-10-03 12:39:43 


2016-10-03 12:39:43 


2016-10-03 12:39:42 


2016-10-03 12:39:41 


2016-09-03 21:16:49 


显示 第 1 到 第 5 条 忆 录 ， 总 共 5 杀 记 录 


图 9-13 ”访问 其 他 设备 


9.7 本章 小 结 


开发 完整 的 物 联 网 系统 是 一 个 复杂 而 艰巨 的 工作 ， 本 章 试图 展现 物 联 网 系统 的 开发 流程 ， 更 多 的 实现 细节 和 调试 经 验 仍 需要 读者 在 具体 实践 过 程 中 不 断 积 累 。 总 的 来 说 ， 物 联网 系统 的 开发 流程 和 互联 
网 系统 并 没有 本 质 的 区 别 ， 物 联网 系统 同样 具备 数据 库 、Web 前 端 和 Web 后 端 ， 此 处 的 微型 物 联 网 系统 仅仅 增加 了 CoAP 接 口 。CoAP 接 口 相 比 于 HITP 接 口 显得 较为 轻 量 ， 更 适合 那些 低 功 耗 受 限 制 设备 实 
用 。 在 Web 开 发 领域 ， 同 时 掌握 Web 前 端 和 Web 后 端 开 发 技能 的 工程 师 称 为 “全 栈 工程 师 ”。 但 在 物 联网 开发 领域 ， 物 联网 工程 师 除 了 要 掌握 必要 的 Web 前 端 和 后 端 开 发 技能 之 外 ， 还 需要 掌握 良好 的 误 入 式 
开发 技能 ， 第 10 章 将 详细 说 明 如 何 使 一 个 低 功 耗 受 限 制 设 备 “ 接 入 ”微型 物 联网 系统 。 


第 10 草 ”微型 物 联网 系统 一 一 设备 部 分 


10.1 ”本草 主要 内 容 


微型 物 联网 系统 不 仅 包括 服务 器 部 分 的 具体 实现 ， 也 包括 设备 部 分 的 具体 实现 。 第 9 章 我 们 已 经 完成 了 服务 器 部 分 的 开发 工作 ， 本 章 我 们 将 继续 推进 设备 部 分 的 开发 工作 。 在 物 联 网 系统 中 ， 终 端 设 备 的 
开发 方 式 多 种 多 样 ， 可 采用 Arduino 这 样 的 小 型 MCU 设 备 ， 也 可 使 用 树 莓 派 这 样 Linux 设 备 。 无 论 如何 设 备 需要 具备 连接 网 络 的 能 力 才 可 以 实现 CoAP 客 户 端 功能 。CoAP 设 计 的 宗旨 便 是 让 低 功 耗 受 限制 设 
备 能 够 连接 网 络 ， 所 以 本 章 试图 在 Contiki 操 作 系统 的 支持 下 实现 一 个 完整 的 CoAP 应 用 。 本 章 的 主要 内 容 包括 : 


.SensotTag 简 介 。 

:Contiki 操 作 系统 的 基本 使 用 方法 。 

- 纯 IPv6 终 端 节点 如 何 访问 IPv4 应 用 。 

: SensotTag 实 现 CoAP 客 户 端 ， 并 向 CoAP 服 务 器 推送 传感器 数据 。 


经 过 本 章 的 学 习 ， 我 们 将 完成 一 个 较为 完整 的 物 联网 系统 。 相 比 于 Web 开 发 ， 谋 入 式 设 备 的 开发 要 更 加 复杂 一 些 ， 开 发 过 程 的 步骤 也 更 多 一 些 ， 所 以 对 本 章 的 学 习 需 要 很 大 的 耐心 。 


第 10 草 ”微型 物 联网 系统 一 一 设备 部 分 


10.1 ”本草 主要 内 容 


微型 物 联网 系统 不 仅 包括 服务 器 部 分 的 具体 实现 ， 也 包括 设备 部 分 的 具体 实现 。 第 9 章 我 们 已 经 完成 了 服务 器 部 分 的 开发 工作 ， 本 章 我 们 将 继续 推进 设备 部 分 的 开发 工作 。 在 物 联 网 系统 中 ， 终 端 设 备 的 
开发 方式 多 种 多 样 ， 可 采用 Arduino 这 样 的 小 型 MCU 设 备 ， 也 可 使 用 树 莓 派 这 样 Linux 设 备 。 无 论 如何 设 备 需要 具备 连接 网 络 的 能 力 才 可 以 实现 CoAP 客 户 端 功能 。CoAP 设 计 的 宗旨 便 是 让 低 功 耗 受 限 制 设 
备 能 够 连接 网 络 ， 所 以 本 章 试图 在 Contiki 操 作 系统 的 支持 下 实现 一 个 完整 的 CoAP 应 用 。 本 章 的 主要 内 容 包括 : 


.SensotTag 简 介 。 

:Contiki 操 作 系 统 的 基本 使 用 方法 。 

- 纯 IPv6 终 端 节点 如 何 访问 IPv4 应 用 。 

. SensofTag 实 现 CoAP 客 户 端 ， 并 向 CoAP 服 务 器 推送 传感器 数据 。 


经 过 本 章 的 学 习 ， 我 们 将 完成 一 个 较为 完整 的 物 联网 系统 。 相 比 于 Web 开 发 ， 谋 入 式 设 备 的 开发 要 更 加 复杂 一 些 ， 开 发 过 程 的 步骤 也 更 多 一 些 ， 所 以 对 本 章 的 学 习 需 要 很 大 的 耐心 。 


10.2 设备 与 网 络 结构 说 明 


10.2.1 设备 说 明 


除了 在 其 他 章节 多 次 出 现 的 树 莓 派 之 外 ， 本 例 中 还 使 用 了 另外 两 个 设备 : SensorTag/CC2650 和 CC2538。SensorTag 是 德州 仪器 推出 的 CC2650 开 发 套件 ， 该 套件 具有 多 种 不 同 的 传感器 ， 其 核心 MCU 
为 CC2650。 而 CC2650 是 新 一 代 无 线 SoC， 同 时 具有 BLE 和 IEEE 802.15.4 两 种 无 线 传输 功能 ，SensorTag 是 本 例 的 “主角 ”。 

更 多 关于 SensorTag 和 CC2650 的 内 容 请 参考 德州 仪器 官方 网 站 : 

- SensorTag: http:/ /processors.wiki.ti.com/index.php/CC2650, SensorTag User's Guide 

: CC2650: http:/ /www.ti.com.cn/ptoduct/cn/CC2650 


除了 “主角 ”SensorTag 之 外 ， 本 例 还 包括 它 的 “好 帮手 ”CC2538。CC2538 是 一 款 符合 IEEE 802.15.4 标 准 的 无 线 SoC， 虽 然 与 CC2650 型 号 不 同 ， 但 在 2.4G 频 段 中 两 者 可 以 进行 正常 的 无 线 通信 。 
CC2538DK 是 德州 仪器 推出 的 CC2538 开 发 套件 之 一 ， 但 是 随 着 CC2538 的 流行 也 可 以 在 其 他 平台 购买 到 与 CC2538DK 兼 容 的 CC2538 开 发 套件 。 


更 多 关于 CC2538 和 CC2538DK 的 内 容 请 参考 德州 仪器 官方 网 站 : 
: CC2538: http:/ /www.ti.com.cn/ptoduct/cn/CC2538 
: CC2538DK:: http:/ /www.ti.com.cn/tool/cn/cc2538dk 


SensorTag 与 CC2538 开 发 板 的 实际 外 观 如 图 10-1 所 示 ，CC2538 开 发 板 与 德州 仪器 推出 的 CC2538DK 保 持 兼 容 。 
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图 10-1 SensotTag 与 CC2538 外 观 


1.SensorTag/CC2650 


本 章 示例 中 并 没有 使 用 SensorTag 的 所 有 功能 ， 而 仅 使 用 了 SensorTag 中 的 温 湿度 传感器 HDC1000、 光 照 传感器 OPT3001 和 UART、LED、 按 键 等 基本 功能 。 其 中 SensorTag 的 UART 功 能 主要 用 于 调 
试 ，LED 将 指示 SensorTag 工 作 状 态 ， 按 键 功能 将 触发 SensorTag 执 行 具 体 工作 ，SensorTag 的 交互 能 力 非 常 有限 ， 但 是 对 于 一 个 物 联网 设备 来 说 这 些 已 经 足够 了 。 关 于 HDC1000 和 OPT3001 这 两 个 传感器 
的 更 多 内 容 请 参考 德州 仪器 官方 网 站 : 


: HDC1000: http:/ /www.ti.com.cn/product/cn/HDC1000 
: OPT3001: http:/ /www.ti.com.cn/ptoduct/cn/OPT3001 


SensorTag/CC2650 的 结构 示意 图 如 图 10-2 所 示 。 
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图 10-2 ”SensorTag/CC2650 结 构 示 意图 
2.CC2538 开 发 板 


与 SensorTag 相 似 ，CC2538 开 发 板 也 具有 多 种 功能 ， 但 是 本 章 示例 中 CC2538 仅 作为 slip-Radio 使 用 ， 也 就 是 说 本 例 仅 使 用 了 CC2538 的 无 线 功 能 和 串口 功能 ，CC2538 将 作为 SensorTag 连 接 传统 网 络 
的 重要 “桥梁 ”。 (CC2538 开 发 板 的 结构 示意 图 如 图 10-3 所 示 。 
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图 10-3 CC2538DK 结 构 示 意图 


10.2 设备 与 网 络 结构 说 明 


10.2.1 ”设备 说 明 

除了 在 其 他 章节 多 次 出 现 的 树 莓 派 之 外 ， 本 例 中 还 使 用 了 另外 两 个 设备 : SensorTag/CC2650 和 CC2538。SensorTag 是 德州 仪器 推出 的 CC2650 开 发 套件 ， 该 套件 具有 多 种 不 同 的 传感器 ， 其 核心 MCU 
为 CC2650。 而 CC2650 是 新 一 代 无 线 SoC， 同 时 具有 BLE 和 IEEE 802.15.4 两 种 无 线 传输 功能 ，SensorTag 是 本 例 的 “主角 ”。 

更 多 关于 SensorTag 和 CC2650 的 内 容 请 参考 德州 仪器 官方 网 站 : 

: SensorTag: http://processors.wiki.ti.com/index.php/CC2650_SensorTag_User's_Guide 


: CC2650: http:/ /www.ti.com.cn/ptoduct/cn/CC2650 


除了 “主角 ”SensorTag 之 外 ， 本 例 还 包括 它 的 “好 帮手 "CC2538。CC2538 是 一 款 符合 IEEE 802.15.4 标 准 的 无 线 SoC， 哩 然 与 CC2650 型 号 不 同 ， 但 在 2.4G 频 段 中 两 者 可 以 进行 正常 的 无 线 通 信 。 
CC2538DK 是 德州 仪器 推出 的 CC2538 开 发 套件 之 一 ， 但 是 随 着 CC2538 的 流行 也 可 以 在 其 他 平台 购买 到 与 CC2538DK 兼 容 的 CC2538 开 发 套件 。 


更 多 关于 CC2538 和 CC2538DK 的 内 容 请 参考 德州 仪器 官方 网 站 : 
: CC2538: http:/ /www.ti.com.cn/ptoduct/cn/CC2538 


: CC2538DK:: http:/ /www.ti.com.cn/tool/cn/cc2538dk 


SensorTag 与 CC2538 开 发 板 的 实际 外 观 如 图 10-1 所 示 ，CC2538 开 发 板 与 德州 仪器 推出 的 CC2538DK 保 持 兼容 。 
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图 10-1 SensotTag 与 CC2538 外 观 
1.SensorTag/CC2650 


本 章 示例 中 并 没有 使 用 SensorTag 的 所 有 功能 ， 而 仅 使 用 了 SensorTag 中 的 温 湿度 传感器 HDC1000、 光 照 传 感 器 OPT3001 和 UART、LED、 按 键 等 基本 功能 。 其 中 SensorTag 的 UART 功 能 主要 用 于 调 
试 ，LED 将 指示 SensorTag 工 作 状 态 ， 按 键 功能 将 触发 SensorTag 执 行 具体 工作 ，sSensorTag 的 交互 能 力 非常 有 限 ， 但 是 对 于 一 个 物 联网 设备 来 说 这 些 已 经 足够 了 。 关 于 HDC1000 和 OPT3001 这 两 个 传感器 
的 更 多 内 容 请 参考 德州 仪器 官方 网 站 : 


: HDC1000: http://www.ti.com.cn/product/cn/HDC1000 


: OPT3001: http://www.ti.com.cn/ptoduct/cn/OPT3001 


SensorTag/CC2650 


SensorTag/CC2650 的 结构 示意 图 如 图 10-2 所 示 。 
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图 10-2 SensorTag/CC265025 4 3 X E 
2.CC2538 开 发 板 


与 SensorTag 相 似 ，CC2538 开 发 板 也 具有 多 种 功能 ， 但 是 本 章 示例 中 CC2538 仅 作为 slip-Radio 使 用 ， 也 就 是 说 本 例 仅 使 用 了 CC2538 的 无 线 功 能 和 串口 功能 ，CC2538 将 作为 SensorTag 连 接 传统 网 络 
的 重要 “桥梁 ”。CC2538 开 发 板 的 结构 示意 图 如 图 10-3 所 示 。 
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图 10-3 CC2538DK 结 构 示 意图 


10.2.2 ”网 络 结构 襄 明 


本 章 的 示例 中 至 少 包 括 三 个 主要 设备 : SensorTag、CC2538 和 树 莓 派 。 其 中 SensorTag 作 为 CoAP 客 户 端 ，SensorTag 与 专用 下 载 器 XDS110 相 连 ，XDS110 不 但 可 以 下 载 固件 至 SensorTag 中 ， 还 可 以 
与 SensorTag/CC2650 的 串口 相连 ， 以 便 在 PC 中 虚拟 一 个 串口 设备 ， 通 过 该 串口 设备 可 以 方便 地 查看 SensorTag/CC2650 的 运行 情况 ; 另外 CC2538 将 作为 Slip-Radio， 把 经 过 6LoWPAN 压 缩 的 IPv6 数 据 包 
变 为 Slip 串 行 数据 并 通过 自身 串口 传输 至 树 莓 派 中 ， 由 于 并 没有 直接 使 用 树 莓 派 中 的 物理 串口 ， 所 以 CC2538 通 过 一 个 USB 转 串口 设备 揪 入 树 莹 派 USB 端 口中 ， 对 树 莓 派 来 说 CC2538 是 一 个 名 为 ttyUSB0 的 串 


行 设备 。 


本 例 中 树 莓 派 作 为 边界 路 由 。 在 6LoWPANV/IPv6 低 功 耗 网 络 中 边界 路 由 的 职责 与 WiFi 网 络 中 的 路 由 器 非常 相似 ， 树 莓 派 把 从 CC2538 获 取 的 无 线 数 据 包 注入 Linux 操 作 系统 的 网 络 层 ， 由 于 SensorTag 是 
一 个 纯 IPv6 节 点 ， 不 能 直接 访问 IPv4 应 用 ， 所 以 需要 在 树 莓 派 中 增加 一 个 NAT64 网 关 ， 通 过 该 网 关 进 行 1Pv6 数 据 包 和 1Pv4 数 据 包 的 双向 转换 。 


最 后 ，IPv4 地 址 为 192.168.0.3 的 主机 将 作为 Web 和 CoAP 服 务 器 ， 在 该 主机 中 运行 微型 物 联网 系统 的 Web 服 务 和 CoAP 服 务 。 本 章 示 例 的 网 络 详细 结构 如 图 10-4 所 示 。 
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图 10-4 ”网 络 结构 示意 图 


10.3 Contiki 入 门 


与 其 他 嵌入 式 开发 不 同 ，Contiki 所 支持 平台 的 开发 工作 一 般 在 Linux 下 进行 ， 常 用 的 Linux 发 行 版 如 Ubuntu、Debian 和 Deepin 等 均 可 进行 Contiki 开 发 。 为 了 简化 Contiki 的 学 习 门 桥 ，Contiki 开 发 团 
队 提 供 了 一 套 集成 开发 环境 一 一 Instant Contiki, Instant Contiki 是 一 套 已 经 安装 好 各 种 依赖 包 和 工具 链 的 Ubuntu 14.04 虚 拟 机 ， 不 需要 任何 配置 便 可 进行 Contiki 开 发 。 在 Instant Contiki 中 已 经 预 装 了 
ARM-Cortex M3 和 MSP430 的 交叉 工具 链 。Instant Contiki 的 更 多 信息 请 参考 Contiki 官 方 网 站 www.contiki-os.org。 


除了 Instant Contiki 集 成 开发 环境 之 外 ， 其 他 Linux 发 行 版 也 可 以 进行 Contiki 开 发 。 在 这 种 情况 下 用 户 需 要 手动 安装 各 种 依赖 工具 和 交叉 工具 链 ， 依 赖 工具 包括 curl、git、wget 和 gcc 等 ， 交 叉 工 具 链 
包括 gcc-arm-none-eabi 和 gcc-msp430 等 。 


10.3.1 ”Contiki 初 步 


下 面 通过 一 个 完整 的 “Hello Contiki” 示 例 说 明 如 何在 Instant Contiki 3.0 中 进行 Contiki 开 发 工作 。 本 小 节 的 相关 步骤 也 可 以 在 其 他 Linux 发 行 版 中 实现 。 


1. 使 用 Instant Contiki 虚 拟 机 


本 节 使 用 Contiki 团 队 提供 的 Instant Contiki 3.0, Instant Contikij 是 一 套 基 于 Ubuntu 14.04 的 32 位 虚拟 机 ， 为 了 运行 Instant Contiki 虚 拟 机 需要 在 Windows 中 安装 虚拟 机 软件 ， 常 见 的 虚拟 机 软件 包 
f&VMware Workstation Player、VisualBox 和 Visual PC 等 。 


实验 环境 说 明 如 下 : 

- 宿主 机 : Windows 10 

- 虚拟 机 软件 : VMware Workstation Player 12.0 

- Linux 发 行 版 : Instant Contiki 3.0 (Ubuntu 14.04 LTS) 


打开 VMware Workstation 12 Player 之 后 ， 在 开始 界面 的 左 侧 选 择 Instant Contiki 3.0， 在 开始 界面 的 右 下 角 选 择 “播放 虚拟 机 ”。 进 入 Instant Contiki 之 后 需要 输入 user 用 户 的 登录 密码 ， 默 认 情况 
下 Instant Contiki 的 默认 用 户 为 user， 登 录 密 码 为 user。 进 入 Instant Contiki 的 具体 操作 过 程 如 图 10-5 和 图 10-6 所 示 。 
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图 10-5 ”选择 Instant Contiki 虚 拟 机 
2. 获 取 Contiki 源 代码 


在 Instant Contiki 3.0 中 已 经 预 装 了 Contiki 的 源 代 码 ， 但 该 部 分 代码 并 不 是 最 新 代码 ，Contiki 源 代码 位 于 user 用 户 目 录 下 的 contiki 文 件 夹 中 。 若 需要 与 Contiki 代 码 仓库 master 分 支 同 步 ， 可 进入 
Contiki 目 录 后 输入 git pull origin 以 获取 最 新 代码 ， 具 体操 作 如 下 : 
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# 进入 Contiki 源 代码 目录 
cd ~/contiki 

# 拉 取 最 新 源 代码 

git pull origin 


另外 使 用 git clone 指 令 也 可 以 获取 最 新 的 Contiki 源 代码 。 


# 复制 Contiki 源 代码 到 用 户 目录 


CO = 

# 获取 Contiki 源 代码 

git clone https://github.com/contiki-os/contiki.git 
# 获取 子 模块 


git submodule update -init 


Contiki 代 码 仓库 除了 包括 Contiki 本 身 之 外 ， 还 包括 多 个 子 模块 。 这 些 子 模块 需要 使 用 git submodule 指 令 初 始 化 并 更 新 。Contiki 的 相关 子 模块 包括 : 
: mspsim: MSP430 软 件 仿真 组 件 ， 该 子 模块 是 Contiki 念 真 环境 Cooja 的 必要 组 件 。 
- cc2538-bsl: CC2538 平 台 串 口 bootload 工 具 ， 该 工具 使 用 Python 开发 。cc2538-bsl 除 了 适用 于 CC2538 平 台 之 外 ， 也 适用 CC2630 和 CC1310 等 SoC。 


* cc26xxware/ccl3xx ware: CC2650 和 CC1310 外 设 驱 动 库 。 该 子 模块 是 CC2650 和 CC1310 开 发 的 必要 组 件 。 


Contiki 源 代码 包含 多 个 目录 ， 这 些 目录 包括 apps (应 用 组 件 ) 、core (核心 代码 ) 、cpu (移植 与 驱动 ) 、platform (平台 实现 ) 、examples (基础 示例 ) 和 tools (实用 工具 ) 等 。Contiki 的 源 代 
码 结构 如 图 10-7 所 示 。 
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图 10-7 ”Contiki 源 代码 结构 
(1) apps 
apps 文 件 夹 包含 Contiki 扩 展 组 件 ， 这 些 组 件 包括 : 
- antelope 组 件 ， 适 用 于 府 入 式 设备 的 超 精简 型 数据 库 系 统 ， 可 在 肉 入 式 Flash 文 件 系 统 的 支持 下 实现 简单 的 增删 改 查 功 能 。 
- er-coap 组 件 和 rest-engine 组 件 ， 该 组 件 同 时 支持 CoAP 客 户 端 和 服务 器 功能 ， 与 CoOAP 有 关 的 组 件 还 包括 ipso-objectl1 组 件 和 oma-lwm2ml 组 件 。 
shell 和 serial-shell 组 件 ， 该 组 件 可 实现 简单 的 串口 控制 人 台 功 能 ，shell 组 件 提供 诸如 设备 重启 、base64 处 理 和 CRC 计 算 等 基础 功能 ， 除 了 这 些 基础 功能 之 外 ， 用 户 还 可 以 根据 需要 增加 自 定义 功能 。 
- Webserver 组 件 ， 该 组 件 提 供 一 个 非常 简单 的 Web 功 能 ， 该 组 件 可 以 帮助 设备 实现 一 些 简 单 的 预定 义 网 页 。 
(2) core 
core 文 件 夹 包含 Contiki 的 所 有 核心 代码 ， 这 些 核心 功能 代码 包括 : 


protothread 任 务 调度 5 


功能 ，Contiki 采 用 事件 触发 机 制 ， 其 核心 为 protothread 任 务 调度 机 制 ， 该 机 制 和 多 数 抢占 式 的 操作 系统 存在 明显 区 别 ， 在 protothread 机 制 下 任务 没有 私有 堆栈 ， 任 务 进行 切换 时 操作 
系统 仅 保留 C 文 件 中 的 行 号 作为 上 下 文 切 换 的 依据 ，protothtread 的 实现 部 分 位 于 sys 目 录 中 。 


.网络 功能 ，Contiki 网 络 功能 包括 精简 的 IPv4 和 IPv6 协 议 栈 ， 支 持 UDP、TCP 和 部 分 HTTP 功 能 ， 与 其 他 具备 IP 功 能 的 嵌入 式 操作 系统 不 同 ，Contiki 网 络 部 分 还 包括 低 功 耗 无 线 传 感 网 相关 的 IEEE 


802.15.4 支 持 层 、6LoWPAN 头 压缩 层 和 RPLH 路 由 功能 
.cfs 文件 系统 ，cfs 文 件 系 统 也 是 Contiki 操 作 系 统 的 一 部 分 ， 该 文件 系统 可 在 CPU 内 部 的 Flash 中 创建 和 使 用 ， 在 cfs 文 件 系 统 的 帮助 下 内 入 式 设备 可 以 方便 地 保存 数据 或 读 取 历 史记 录 。 
(3) cpu 


Contiki 支 持 的 CPU 种 类 较 多 并 且 依 然 在 不 断 扩充 ，Contiki 支 持 的 CPU 包括 STM32F 152 系 列 、CC2538 系 列 、CC1310/CC2650 系 列 、MSP430F1/F2/F5 系 列 、nRF52 系 列 。Contiki 操 作 系 统 完全 由 C 
语言 实现 并 不 包括 任何 汇编 代码 ， 简 单 来 说 Contiki 操 作 系 统 仅 需 实现 一 个 系统 时 钟 便 可 完成 移植 ， 对 于 绝 大 多 数 ARM-Cortex CPU 而 言 ，Systick 时 钟 是 一 个 非常 合适 的 系统 时 间 载 体 。 总 而 言 之 ，Contiki 
操作 系统 几乎 可 以 移植 到 任何 CPU 中 。cpu 目 录 中 有 一 个 特殊 的 cpu 一 native， 该 cpu 可 以 理解 为 把 Contiki 操 作 系统 “移植 ”到 Linux 系 统 中 ， 那 么 Contiki 的 部 分 功能 也 可 以 在 Linux 平 台 下 实现 并 验证 。 


(4) platform 


platform 文 件 夹 包 含 Contiki 操 作 系统 所 支持 的 各 类 平台 ， 这 些 平台 包括 CC2538DK 平 台 、SRF06-CC26xx (CC1310/CC2650) 平台 ，STM32 NUCLEO 平 台 等 。 在 CPU 移植 的 基础 上 ， 这 些 平台 还 增 
加 了 各 种 外 设 、 传 感 器 和 执行 器 。 每 个 平台 下 都 包含 contiki-main.c 和 contiki-conf.h，contiki-main.c 中 包含 main 函 数 ， 实 现 了 绝 大 多 数 初始 化 工作 ， 如 操作 系统 初始 化 、 网 络 组 件 初 始 化 、 辅 助 功能 初始 
化 和 低 功 耗 实现 等 功能 ， 在 platform 的 帮助 下 用 户 仅 需要 关心 具体 功能 实现 便 可 ;contiki-conf.h 包 含 与 平台 相关 的 默认 Contiki 本 置 ， 熟悉 Contiki 的 所 有 配置 并 不 是 一 件 容 易 的 事情 。 用 户 也 可 以 参考 相似 
的 平台 创建 符合 自身 要 求 的 platform。 


(5) examples 


examples 文 件 夹 包括 大 量 基 础 示例 ， 这 些 示例 包括 不 同 平台 下 的 UDP 客户 端 服务 器 示例 、 传 感 器 示例 、 任 务 调度 示例 、 定 时 器 组 件 (etimer、ctimer 和 rtimer) 示例 ; 除了 有 具体 平台 的 示例 之 
外 ，examples 平 台 还 包括 边界 路 由 示例 、slip-Radio 示 例 等 实用 功能 。 


(6) tools 
tools 文 件 夹 中 包含 很 多 使 用 Contiki 过 程 中 的 实用 工具 ， 这 些 实用 工具 包括 : 
- CC2538-bsl 工 具 : 使 用 该 工具 可 以 通过 串口 下 载 固 件 ，CC2538-bsl 支 持 CC2538、CC2650 和 CC1310 等 。 


: cooja 仿 真 工具 : cooja 仿 真 工具 是 Contiki 的 一 个 特色 工具 ， 借 助 该 工具 可 以 在 纯 软 件 环境 下 模拟 无 线 传 感 网 络 ，cooja 仿 真 工具 既 可 支持 多 个 终端 节点 ， 也 可 以 支持 边界 路 由 ， 但 cooja 仿 真 工具 仅 支持 
MSP430 相 关 平 台 。 并 不 能 仿真 ARM Cottex 系 列 平台 。 


: tools 目 录 中 tunslip6 是 一 个 常用 工具 ， 在 Contiki 应 用 系统 中 低 功 耗 无 线 传 感 网 络 一 般 存 在 一 个 边界 路 由 ， 该 边界 路 由 实现 RPL Root 功能 ， 该 路 由 设备 将 把 低 功 耗 传 感 网 中 需要 转发 的 IP 数 据 包 重 新 组 装 
为 slip 格 式 并 通过 串口 发 送 至 Linux 主 机 ，tunslip6 工 具 侦 听 指 定 的 串口 ， 并 把 需要 转发 的 IPv6 数 据 包 注 入 到 Linux 网 络 层 驱动 中 。 


(7) makefile.include 
makefile.include 是 Contiki 的 核心 makefile 文 件 ， 阅 读 或 学 习 makefile.include 的 细节 可 不 是 一 件 容易 的 事情 。 


[1] https:/ /www.ipso-alliance.org/ o 
[2] http:/ /openmobilealliance.org/iot/ o 
[3] https:/ /datatracker.ietf.org/doc/tfc6550/ , 


10.3.2 nativeAT Jzs £l 


下 面 我 们 在 Instant Contiki 中 实现 一 个 最 为 简单 的 “hello world” 示 例 ， 该 示例 位 于 examples/hello-world 目 录 中 ， 通 过 cd 指令 进入 该 目录 后 运行 “make TARGET=native” 便 可 生成 可 执行 文件 ， 
具体 操作 步骤 如 下 : 


EI 


# XtAhello-worldH3* 
cd -/contiki/exapmples/hello-world 
* 使 用 native 平 台 

make TARGET-native 


TARGET 参 数 用 于 指定 平台 ，native 平 台 是 Contiki 所 支持 的 平台 中 较为 特殊 的 平台 ，native 平 台 一 般 特 指 Linux 平 台 ， 该 平台 在 Linux 系 统 内 仿真 Contiki 系 统 所 需 的 运行 环境 。 此 时 经 make 编 译 获 得 的 
可 执行 文件 为 hello-world.native， 该 文件 可 在 Linux 系 统 中 直接 运行 。 在 控制 台中 输入 “./hello-world.native” 可 获得 类 似 输出 。 


# 运行 可 执行 文件 ./hello-world.native 
./hello-world.native 
# contiki-main.c 中 输出 
Contiki-3.x-2906-gl4bfaff started with IPV6, RPL 

Rime started with address 1.2.3.4.5.6.7.8 

MAC nullmac RDC nullrdc NETWORK sicslowpan 

Tentative link-local IPv6 address fe80:0000:0000:0000:0302:0304:0506:0708 
# hello world.c 中 输出 

Hello, world 

# 使 用 Ctrltc 退出 


控制 台中 除了 输出 “Hello，world” 之 外 ， 还 给 出 了 很 多 提示 信息 ， 这 些 提示 信息 由 native 平 台 下 的 contiki-main.c 中 输出 ， 而 hello-world.c 中 仅 输 出 “Hello，world”。 下 面 我 们 再 来 分 析 hello- 
world.c 文 件 ，hello-world.c 的 具体 实现 如 下 : 


代码 清单 10-1 native hello-world.c 


finclude "contiki.h" 

finclude <stdio.h> 

PROCESS (hello world process, "Hello world process"); 
AUTOSTART PROCESSES (&hello world process); 

PROCESS THREAD (hello world process, ev, data) 

{ 


PROCESS BEGIN(); 
printf("Hello, worldNn"); 
PROCESS END(); 


虽然 hello-world.c 示 例 非常 简单 ， 但 已 经 包括 了 protothread 机 制 涉及 的 常用 宏 定义 一 一 PROCESS (..) , PROCESS THREAD (..) . PROCESS BEGIN () . PROCESS END () 和 
AUTOSTART PROCESSES (..) . 


: PROCESS (hello world process, "Hello world process") : PROCESS 宏 用 于 任务 声明 ， 此 处 声明 一 个 hello_world_process 任 务 。 


: AUTOSTART PROCESSES (&hello world process) : AUTOSTART PROCESSES 宏 用 于 设置 “ 自 启 动 ”任务 ，hello_wotd_ptocess 任 务 加 入 到 自 启动 任务 列表 中 ，Contiki 操 作 系 统 完 成 初始 化 工作 之 
后 便 会 启动 该 任务 。 


: PROCESS THREAD (hello world process, ev, data) (1: 在 任务 主体 中 ， 任 务 主体 总 是 以 PROCESS_BEGIN () 开始 并 以 PROCESS_END () 结束 ， 此 处 hello_world_process 任 务 中 并 没有 while (1) 
循环 结构 ， 所 以 任务 运行 一 次 。 


10.3.3 ”安装 交叉 工具 链 


一 个 入 门 级 别 的 “Hello World”″” 示 例 虽 然 并 没有 太 多 的 使 用 价值 ， 但 是 该 示例 却 展现 了 使 用 protothread 的 基本 方法 ， 现 在 我 们 可 以 把 native 的 成 功 经 验 迁 移 到 CC2538dk/SensorTag 平 台中 。 
SensorTag 平 台 和 native 平 台 不 同 ，SensorTag 平 台 的 开发 依赖 于 gcc-arm-embedded 交 叉 工 具 链 。gcc-arm-embedded 交 叉 工 具 链 的 更 多 信息 请 参考 : https;//launchpad.net/gcc-arm-embedded, 
下 面 介 绍 gcc-arm-embedded 工 具 链 安装 的 两 种 方法 : Ubuntu PPA 方 法 和 软件 包 直 接 安装 法 。 


1.Ubuntu PPA 方 法 


如 果 使 用 Ubuntu 发 行 版 ， 可 通过 Ubuntu PPA 服 务 安装 较 新 版 本 的 gcc-arm-embedded 交 叉 工具 链 ， 在 控制 台中 依次 输入 以 下 指令 : 


# Instant Contiki 中 已 经 预 装 了 gcc-arm-embeqqed 工 具 链 
# 可 使 用 apt-get removefd&-$ HA iIH THE 

udo apt-get remove gcc-arm-none-eabi 

增加 gcc-arm-embeqqeq 软 件 源 仓库 
udo add-apt-repository ppa:team-gcc-arm-embedded/ppa 
更 新 软件 源 
udo apt-get update 


Q #0 #U#U 


udo apt-get install gcc-arm-embedded 


2. 软 件 包 直接 安装 法 
其 他 Linux 发 行 版 也 可 以 通过 下 载 软 件 包 的 方式 安装 gcc-arm-embedded 交 叉 工 具 链 。 下 面 以 gcc-arm-none-eabi 5.4 版 本 为 例 说 明 安 装 gcc-arm-embedded 的 具体 方法 。 


# 获取 gcc-arm-embedded 软 件 安 装 包 

wget https://launchpadlibrarian.net/287101520/gcc-arm-none-eabi-5 4-2016q3-20160926- 
linux.tar.bz2 E 
# 复制 安装 包 到 /usr/Local 目 录 
sudo cp gcc-arm-none-eabi-5 4-2016q03-20160926-1inux.tar.bz2 /usr/local 
# 在 /usr/local 目 录 下 解压 软件 安装 包 
cd /usr/local 

sudo tar -jxvf gcc-arm-none-eabi-5 4-2016q3-20160926-1linux.tar.bz2 


iBgcc-arm-none-eabi-5 4 解压 至 /usVlocal 之 后 ， 并 不 能 立即 使 用 gcc-arm-embedded 工 具 链 ， 还 需要 把 交叉 工具 链 的 具体 路 径 加 入 到 用 户 环境 变量 中 。 


# 使 用 nano 打 开 bashrc 

sudo nano ~/.bashrc 

# 在 bashrc 文 件 的 最 后 一 行 增加 
PATH-SPATH:/usr/local/gcc-arm-none-eabi-5 4-2016q3/bin 
# 退出 nano 

# 立即 更 新 环境 变量 


1 
E 
source -/.bashrc 


3. 安 装 验证 


完成 交叉 工具 链 安装 之 后 ， 在 控制 台中 输入 “arm-none-eabi-gcc-V” 便 可 查看 该 工具 是 否 安装 成 功 ， 若 交叉 工具 链 安装 成 功 可 在 控制 台中 看 到 如 图 10-8 所 示 内 容 。 


10.3.4 SensorTag 入 门 示例 


完成 了 交叉 工具 链 的 安装 之 后 ， 我 们 立马 着 手 SensorTag 平 台 上 的 “Hello World” 示 例 。SensorTag 的 “Hello World” 示 例 比 native 的 “Hello World” 示 例 更 复杂 一 些 。 


1. 修 改 makefile.user.include 


与 设备 相关 的 代码 均 位 于 本 书 代码 仓库 the_beginning_of coap/microsystem_device 目 录 中 ， 该 目录 下 有 一 个 名 为 makefile.user.include 的 文件 ， 该 文件 用 于 指定 Contiki 源 代码 的 具体 位 置 ， 在 前 面 
的 小 节 中 Contiki 源 代码 被 复制 至 user 用 户 根 目录 中 ， 那 么 Contiki 源 代码 的 绝对 位 置 为 /home/usercontiki。 请 根据 实际 情况 修改 Contiki 源 代码 的 具体 位 置 ， 否 则 将 导致 SensorTag 入 门 示例 和 其 他 所 有 示 
例 编译 失败 。makefile.user.include 的 具体 内 容 如 下 : 


APPDIRS+=$ (USER FOLDER) /apps 
TARGETDIRS+=$ (USER FOLDER) /platform 


# 指 定 contiki 源 代码 目录 位 置 

# 请 务必 根据 实际 情况 修改 
CONTIKI=/home/user/contiki 

include $ (CONTIKI) /Makefile.include 


i O_o user@instant-contiki: ~ 
File Edit View Search Terminal Help 


user@instant-contiki:~$ arm-none-eabi-gcc -v 

Using built-in specs. 

COLLECT GCC-zarm-none-eabi-gcc 

COLLECT LTO WRAPPER-/usr /bin/../lib/gcc/arm-none-eabi/5.4.1/lto-wrapper 

Target: arm-none-eabi 

Configured with: /build/gcc-arm-none-eabi-Iki1ovi1/gcc-arm-none-eabi-5-2016q083/src/gcc/configu 
re --target-arm-none-eabi --prefix-/build/gcc-arm-none-eabi-Ik10ovi1/gcc-arm-none-eabi-5-2016 

q3/install-native --libexecdir-/build/gcc-arm-none-eabi-Ik10vi/gcc-arm-none-eabi-5-2016q83/i 

nstall-native/lib --infodir-z/build/gcc-arm-none-eabi-Iki10v1/gcc-arm-none-eabi-5-2016q83/inst 

all-native/share/doc/gcc-arm-none-eabi/info --mandirz/build/gcc-arm-none-eabi-Ik1ovi1/gcc-ar 

m-none-eabi-5-2016q93/install-native/share/doc/gcc-arm-none-eabi/man --htmldir-/build/gcc-ar 

m-none-eabi-Ikiovi1/gcc-arm-none-eabi-5-2016q93/install-native/share/doc/gcc-arm-none-eabi/ht 

ml --pdfdir-z/build/gcc-arm-none-eabi-Iki0ovi/gcc-arm-none-eabi-5-2016q83/install-native/share 
/doc/gcc-arm-none-eabi/pdf --enable-languages-c,c«« --enable-plugins --disable-decimal-floa 
t --disable-libffi --disable-libgomp --disable-libmudflap --disable-libquadmath --disable-l 

ibssp --disable-libstdcxx-pch --disable-nls --disable-shared --disable-threads --disable-tl 
S --with-gnu-as --with-gnu-ld --with-newlib --with-headers-yes --with-python-dir-share/gcc- 
arm-none-eabi --with-sysroot-/build/gcc-arm-none-eabi-Iki10vi/gcc-arm-none-eabi-5-2016q3/ins 
tall-native/arm-none-eabi --with-host-libstdcxx-'-static-libgcc -Wl,-Bstatic,-lstdc«-«,-Bdyn 
amic -lm' --with-pkgversion-'GNU Tools for ARM Embedded Processors' --with-multilib-list-arn 
mv6-m,armv7-m,armv7e-m,armv7-r,armv8-m.base,armv8-m.main 

Thread model: single 

gcc version 5.4.1 20160919 (release) [ARM/embedded-5-branch revision 240496] (GNU Tools for 
ARM Embedded Processors) 

userginstant-contiki:-$ [| 


图 10-8 ”验证 atm-none-eabi-gcc 工 具 链 


SensorTag 入 门 示 例 位 于 /examples/sensortag/hello-world 目 录 中 ， 该 文件 夹 中 包括 : hello-world.c、project-conf.h、Makefile.target 和 Makefile 四 个 文件 ， 其 中 hello-world.c 文 件 的 具体 内 容 如 


代码 清单 10-2 SensorTag hello-world.c 


#include "contiki.h" 

#include "dev/leds.h" 
#include "net/ipv6/uip-ds6.h" 
#include <stdio.h> 


PROCESS (hello world process, "hello world process"); 
PROCESS (simple process, "simple process"); 
AUTOSTART PROCESSES (&hello world process); 


ROCESS THREAD (hello world process, ev, data) 


CEU 


static struct etimer et reg; 
PROCESS BEGIN(); 


etimer set(&et red, CLOCK SECOND / 8); 
printf ("hello world!^n"); 
while(1) { 

PROCESS YIELD(); 


if (ev == PROCESS EVENT TIMER && etimer expired(&et red)) { 
if(uip ds6 get global(ADDR PREFERRED) != NULL) { 


Ff (LEDS RED); 
printf ("device has joined the net"); 
process start(&simple process, NULL); 


leds toggle (LEDS RED); 
etimer set(&et red, CLOCK SECOND / 8); 


} 


PROCESS END(); 


} 
PROCESS _ THREAD (simple process, ev, data) 
{ 


static struct etimer et green; 
PROCESS BEGIN(); 


printf ("simple processWM"); 
etimer set(&et green, CLOCK SECOND / 4); 


while(1) { 
PROCESS YIELD(); 
if (ev == PROCESS EVENT TIMER && etimer expired(&et green)) { 


leds toggle (LEDS GREEN); 
etimer set(&et green, CLOCK SECOND / 4); 


PROCESS END(); 


hello-world.c 中 包含 两 个 任务 : hello_world_process 和 和 simple_process。hello_world_process 任 务 周期 性 查看 设备 是 否 已 经 获得 IPv6 网 络 前 级 ， 如 果 和 暂 未 分 配 到 网 络 前 经， 则 令 红 色 LED 不 停 内 炼 ; 
如 果 已 经 分 配 到 网 络 前 缀 ， 那 么 关闭 红色 LED 并 启动 simple_process 任 务 。 


- PROCESS (hello world, process, "hello world process") : 声明 hello_world_process 任 务 ， 并 把 该 任务 设置 为 自 启动 。 


: PROCESS (simple process, "simple process") : 声明 simple_process 任 务 。 


static struct etimer et red; etimer set (&et red, CLOCK, SECOND/8) : 在 hello_wotld_ptocess 任 务 中 增加 一 个 etimet 定 时 器 ， 该 定时 器 为 Contiki 中 的 一 个 默认 组 件 ， 定 时 器 的 溢出 时 间 为 
CLOCK SECOND/8 也 就 是 125ms。 
. PROCESS. YIELD () : 任务 挂 起 等 待 系统 时 间 。 
“ if (ev==PROCESS_EVENT TIMER&&etimer expired (&et red) ) : 任务 获得 一 个 定时 器 事件 ， 且 定时 器 etimet 为 在 该 任务 中 创建 的 et_red 定 时 器 。Contiki 中 通过 etimer 实 现任 务 的 周期 性 运行 。 
uip ds6 get global (ADDR_PREFERRED) ! =NULL: 获取 全 局 IPv6 网 络 前 级 ， 该 前 级 由 边界 路 由 分 配 。 如 果 该 设备 未 分 配 到 IPv6 网 络 前 级 ， 再 次 启动 et_red 定 时 器 ， 超 时 依然 为 
CLOCK_SECOND/8。 


* process start (&simple process, NULL) : 如 果 分 配 到 IPv6 网 络 前 级 ， 则 启动 simple 任 务 。 


simple_process 任 务 是 典型 的 周期 性 处 理 任务 ， 但 是 该 任务 并 不 会 开机 自动 ， 该 任务 是 否 启 动 取决 于 设备 是 否 已 经 获取 IPv6 网 络 前 缀 。 


3. 生 成 hello-world.hex 


下 面 我 们 尝试 生成 HEX 格 式 固 件 ， 在 控制 台中 输入 : 


# 进入 hel1lo-world 示 例 目录 
cd examples/sensortag/hello-world 


# 生成 固件 
make BOARD-sensortag/cc2650 


在 hello-world 目 录 下 将 生成 hello-world.hex 文 件 ， 该 文件 便 是 hello-world 示 例 的 最 终 固件 。 若 在 Instant Contiki 3.0 中 生成 固件 ， 可 以 在 Instant Contiki 3.0 中 复制 hello-world.hex， 切 换 至 
Windows 操 作 系 统 后 直接 粘贴 到 合适 的 目录 即 可 ; 若 使 用 其 他 Linux 发 行 版 需要 在 虚拟 机 中 安装 VMware Tools 工 具 ， 该 工具 可 实现 Linux 虚 拟 机 和 Windows 主 机 之 间 的 复制 与 粘贴 操作 。Linux 虚 拟 机 和 


Windows 主 机 之 间 传 输 的 文件 的 方法 还 包括 FTP 和 共享 文件 夹 等 方法 。 


4. 下 载 hello-world.hex 


SensorTag/CC2650 的 固件 下 载 操作 需要 借助 XDS110 下 载 工具 ( 见 图 10-9) 和 Flash Programmer2 下 载 软件 。 相 关 软件 与 工具 的 详细 介绍 和 使 用 方法 请 参考 德州 仪器 官方 网 站 。 


: XDS110: http://processots.wiki.ti.com/index.php/Debug DevPack User Guide 


: Flash Programmet2: http: / /www.ti.com.cn/tool/cn/flash-programmet 


a) SensorTag^| 5c b) SensorTag c) XDS110 F Ze 


图 10-9 ”SensorTag 和 XDS110 下 载 器 


为 了 顺利 下 载 固件 首先 需要 拆除 SensorTag 的 保护 外 壳 ， 把 SensorTag 底 板 与 XDS110 下 载 器 相连 ， 然 后 通过 USB 连 接线 与 Windows 主 机 相连 。 打 开 Flash Programmer2 下 载 软件 把 hello-world.hex 文 
件 下 载 至 SensorTag 中 ， 具 体操 作 过程 如 图 10-10 所 示 。HEX 文 件 下 载 完 成 之 后 SensorTag 将 自动 重启 。 
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图 10-10 F Xhello-wotld.hex 


5. 运 行 hello-world.hex 


固件 下 载 完成 之 后 ，SensorTag 将 进入 正常 运行 模式 ，XDS110 下 载 工具 将 在 Windows 主 机 中 虚拟 一 个 串口 设备 ， 利 用 该 串口 设备 可 以 观察 SensorTag 的 运行 情况 ， 通 过 串口 调试 工具 可 以 观察 到 以 下 
类 似 输出 信息 : 


# contiki-main.c 中 输出 
Starting Contiki-3.x-2906-gl4bfaff 
ith DriverLib v0.46593 
CC2650 SensorTag 
tarting Contiki-3.x-2906-gl4bfaff 
ith DriverLib v0.46593 
I CC2650 SensorTag 
et: sicslowpan 

MAC: CSMA 
RDC: ContikiMAC, Channel Check Interval: 16 ticks 
RF: Channel 25 
Link layer addr: 00:12:4b:00:07:c9:40:03 
Node ID: 19203 
# hello-world.c 中 输出 
hello world! 


zdzudz 


SensorTag 的 串口 输出 信息 大 致 可 分 为 两 部 分 : 一 部 分 为 contiki-main.c 输 出 内 容 ， 另 一 部 分 为 hello-world.c 输 出 内 容 。contiki-main.c 中 输出 了 当前 Contiki 的 版 本 编号 ，CC2650 相 关 driverlib 的 版 本 
编号 、Platform 名 称 、MAC 层 和 RDC 层 选用 组 件 情况 、 射 频 部 分 工作 信号 、CC2650 链 路 层 MAC 地 址 等 基本 信息 。hello-world.c 中 的 输出 信息 则 相对 简单 ， 仅 包括 “hello world! " , 


此 时 SensorTag 的 红色 LED 将 会 不 停 地 闪烁 ， 由 于 并 没有 边界 路 由 设备 ， 所 以 Sensor Tag 始 终 无 法 加 入 网 络 ， 也 无 法 获得 全 局 网 络 前 缀 。sensorTag 与 外 部 网 络 建立 联系 必须 要 依赖 于 边界 路 由 。 


10.4 ”搭建 边界 路 由 


在 WiFi 组 成 的 无 线 局 域 网 中 一 般 存在 两 种 角色 : WiFi AP 和 WiFi Station, WiFi AP 即 俗称 的 无 线路 由 器 ， 而 手机 或 者 个 人 笔记 本 则 扮演 WiFi Station 角 色 。 在 Contiki 所 支持 的 IEEE 802.15.4 无 线 局 域 网 
中 ，SensorTag 扮 演 终端 设备 ， 这 和 WiFi 无 线 局 域 网 中 的 手机 和 个 人 笔记 本 所 扮演 的 角色 相似 。 边 界 路 由 则 扮演 与 无 线路 由 器 相似 的 角色 ， 它 把 无 线 数据 “翻译 ”为 有 线 数据 ， 可 以 说 边界 路 由 是 低 功 耗 无 
线 网 络 与 传统 互联 网 之 间 的 桥梁 。 


在 多 数 情况 下 ，WiFi 无 线路 由 器 仅 需 传递 |Pv4 报 文 ， 但 在 此 处 的 无 线 网 络 中 边界 路 由 需要 做 更 多 的 工作 ， 它 需要 把 经 过 6LoWPAN 技 术 压 缩 的 IPv6 报 文 还 原 为 完整 的 |Pv6 报 文 。 由 于 具体 网 络 的 限制 ， 
边界 路 由 还 需要 把 1Pv6 报 文 转化 为 合适 的 I|Pv4 报 文 。 


Contiki 中 有 多 种 创建 边界 路 由 的 方法 ， 本 小 节 将 介绍 Slip-Radio+ Native-Border-Router 方 法 。 本 小 节 中 CC2538 用 于 实现 Slip-Radio， 而 树 莓 派 用 于 实现 Native-Border-Router， 本 节 的 主要 工作 如 
图 10-11 所 示 。 


10.4.1 创建 Slip-Radio 


slip 是 串 行 线路 接口 协议 的 简称 ， 它 是 一 种 点 对 点 网 络 解决 方案 ，slip 协 议 是 一 种 非常 古老 的 串 行 线路 接口 协议 ， 该 协议 提供 了 一 种 非常 简单 的 封装 IP 数 据 包 的 方法 。slip 协 议定 义 一 个 称 为 slip end 的 
界定 符 ， 该 值 为 192 (0xCO) ， 该 界定 符 被 追加 到 IP 数 据 包 的 末尾 ， 利 用 该 界定 符 判 断 IP 数 据 包 是 否 完整 。 在 |P 数 据 包 中 也 会 出 现 其 他 的 0xC0， 为 了 解决 这 种 冲突 ，slip 协 议 又 定义 了 一 个 slip esc 界 定 符 ， 
该 值 为 219 (0xDB) 。 当 IP 发 送 数据 包 中 包含 0xC0 时 ， 它 被 自动 替换 为 0xDB 0xDC 两 个 字符 ， 这 样 可 以 避免 与 结尾 界定 符 0xC0 产 生 冲突 。 
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图 10-11 搭建 边界 路 由 主要 工作 


slip-Radio 把 无 线 传 感 网 中 的 I|Pv6 数 据 转化 为 使 用 串 行 接口 的 slip 数 据 ， 那 么 Native-Border-Router 便 可 使 用 诸如 ttyUSB0 这 样 的 串 行 设备 接收 slip 分 包 数 据 ， 并 把 这 些 分 包 数 据 注入 到 Linux 网 络 层 中 。 
Slip-Radio 的 相关 实现 代码 位 于 本 书 代码 仓库 microsystem_device\examples\ipv6\slip-radio 目 录 中 。 


1. 生 成 slip-Radio 固 件 


本 节 示 例 使 用 CC2538DK 平 台 生成 Slip-Radio 固 件 ， 具 体操 作 如 下 : 


# 进入 Slip-Radio 目 录 

cd examples/ipv6/slip-radio 
# 在 CC2538 平 台 下 生成 

make TARGET=cc2538dk 


2. 下 载 Slip-Radio 固 件 


CC2538 的 固件 烧 写 方式 和 SensorTag/CC2650 相 似 ， 借 助 Flash Programmer2 和 XDS100/XDS110 下 载 工具 便 可 完成 操作 。 


10.4.2 创建 Native-Border-Router 


完成 Sip-Radio 的 工作 之 后 ， 我 们 接着 在 树 莓 派 中 创建 Native-Border-Router。 
1. 树 莓 派 中 复制 Contiki 源 代码 


在 树 莓 派 控制 台 获 取 Contiki 源 代码 ， 可 在 树 莓 派 控 制 台 中 输入 以 下 内 容 : 


# 进入 repo 目 录 
cd ~/repo 
# 获取 Contiki 源 代码 

git clone https://github.com/contiki-os/contiki.git 
# 获取 子 模块 并 更 新 子 模块 


git submodule update -init 


2. 创 建 Native-Border-Router 


编译 native-border-router 之 前 需要 在 树 答 派 中 安装 必要 的 依赖 项 。native-border-router 位 于 Contiki 源 代码 目录 中 的 examples/ipv6 目 录 下 ， 进 入 native-border-router 文 件 夹 ， 通 过 make 
TARGET=native 便 可 生成 可 执行 文件 border-routernative， 该 可 执行 文件 可 在 树 莓 派 中 直接 运行 。 


# 更 新 软件 源 

sudo apt-get update 

# 安装 必要 的 依赖 项 

sudo apt-get install libncurses5-dev 

# 3tAnative-border-routerH3* 

cd -/repo/contiki/examples/ipv6/native-border-router 
# 生成 可 执行 文件 
make TARGET-native 


3.border-router.native 使 用 方法 
在 树 莓 派 控制 台中 输入 “./border-router.native-h” 便 可 查看 border-router.native 的 使 用 方法 ， 常 用 的 参数 如 下 : 


(B: 指定 串 行 通 信 波 特 率 ， 软 认为 115200。 


. -a: 用 于 指定 主机 IP 地 址 ， 该 参数 只 有 在 cooja 念 真 才 被 使 用 。 
--p: 用 于 指定 服务 端口 号 ， 该 参数 只 有 在 cooja 仿 真 才 被 使 用 。 


- ipaddress: 用 于 指定 全 局 网 络 前 级 ， 一 般 为 fd00: : 1/64. 


# 查看 border-router.native 使 用 方法 
./border-router.native -h 
usage:  ./border-router.native [options] ipaddress 
example: border-router.native -L -v2 -s ttyUSB1 fd00::1/64 
Options are: 


-B baudrate 9600,19200,38400,57600,115200,921600 (default 115200) 
-H Hardware CTS/RTS flow control (default disabled) 

-L Log output format (adds time stamps) 

-s siodev Serial device (default /dev/ttyUSBO) 

-a host Connect via TCP to server at «host» 

-p port Connect via TCP to server at «host»:«port» 

-t tundev Name of interface (default tun0) 


jaSlip-Radio3: USB£eERLTi& eS Eb EEUKTHEE, YERESGIARUÉE0-12B9r m. —ESlip-Radio Eb &jJK1ESEf, TuEEIKHRTS IL 1$ 73ttyUSBOBRSiS E. 
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图 10-12  Slip-Radio -5 pt% Jk 3 4 


在 树 莓 派 控 制 台中 输入 以 下 命令 : 


sudo ./border-router.native -s /dev/ttyUSBO fd00::1/64 


由 于 需要 操作 /dev 目 录 下 的 ttyUSB0 设 备 ， 所 以 此 处 需要 使 用 sudo 权 限 ， 通 过 -s 参 数 指定 使 用 ttyUSB0 设 备 ， 在 此 处 的 IPv6 网 络 的 全 局 网 络 前 缀 为 fd00: : 1/64，64 表 示 网 络 ID 为 IPv6 地 址 的 前 64 位 。 
若 border-router.native 正 常 运行 ， 那 么 在 树 莓 派 控 制 人 台中 可 获得 以 下 输出 内 容 : 


# 控制 台 输 出 

RPL-Border router started 

********SLIP started on ''/dev/ttyUSBO'' 

opened tun device ''/dev/tun0'' 

ifconfig tun0 inet "hostname up 

ifconfig tun0 add fd00::1/64 

ifconfig tuno 

# 省 略 部 分 内 容 

Setting prefix fd00::1 

created a new RPL dag 

Server IPv6 addresses: 
0x49ba4: —»fd00::212:4000:5af:8404 
Ox49bc4: =>fe80::212:4b00:5af:8404 


4. 加 入 开机 启动 项 
为 了 更 方便 地 使 用 边界 路 由 ， 可 以 把 border-router.native 加 入 到 树 莓 派 开机 启动 项 中 ， 通 过 编写 /etc/rc.local 文 件 便 可 增加 用 户 开机 启动 项 。 


# ABON REIRI BUR Z 


sudo nano /etc/rc.local 


在 /etc/rc.local 文 件 中 增加 Native-Border-Router 启 动 相关 操作 。 先 通过 cd 指令 进入 border-routernative 可 执行 文件 所 在 目录 ， 然 后 通过 -s 参 数 指 定 串 行 设备 名 称 ， 一 般 为 “/dewttyUSB0” , IPv6 
全 局 网 络 前 缀 为 “fd00: : 1/64" ， 指 令 最 后 的 “&” 符号 表示 border-router.native 处 于 后 台 运 行 状 态 。 此 处 还 需要 注意 以 下 几 点 内 容 : 


" 此 处 虽然 需要 操作 /dev/ttyUSB0 设 备 ， 但 在 tc.local 文 件 中 并 不 需要 使 用 sudo 权 限 ， 盲 目 增加 sudo 权 限 将 导致 fc.local 运 行 异 常 。 
: 用 户 增加 的 开启 启动 项 目 一 定 要 出 现在 “exit 0” 之 前 。 


# 执行 hative-border-router 
cd /home/pi/repo/contiki/examples/ipv6/native-border-router 
./border-router.native -s /dev/ttyUSBO fd00::1/64 & 


exit 0 


重新 局 动 树 莓 派 完成 修改 动作 。 
5. 再 次 运行 SensorTag 


重启 树 莓 派 之 后 ，SensorTag 重 新 上 电 并 再 次 运行 hello-world， 红 色 LED 闪 炬 一 定时 间 之 后 便 会 熄火 。 若 红色 LED 停 止 内 烁 说 明 SensorTag 已 经 加 入 到 由 树 莓 派 内 Native-Border-Router 所 建立 的 低 功 
耗 无 线 局 域 网 中 。 与 SensorTag 相 连 的 串口 控制 台 将 输出 以 下 内 容 : 


f contiki-main.c 

TI CC2650 SensorTag 

Net: sicslowpan 

MAC: CSMA 

RDC: ContikiMAC, Channel Check Interval: 16 ticks 
RF: Channel 25 

Link layer addr: 00:12:4b:00:07:c9:4b:03 

Node ID: 19203 

# hello-world.c 

hello world! 

# 成 功 加 入 低 功 耗 无 线 局 域 网 
device has joined the net 
simple process 


低 功 耗 无 线 局 域 网 的 构建 依赖 于 RPL 组 件 ， 而 RPL 组 件 是 Contiki 的 重要 组 件 之 一 。 在 构建 hello-world 固 件 时 已 经 在 其 中 加 入 了 RPL 组 件 ，Contiki 操 作 系 统 帮 助 用 户 完成 了 终端 设备 加 入 低 功 耗 局 域 网 的 
大 多 数 工 作 ， 而 用 户 仅 需 专注 于 具体 应 用 便 可 。RPL 机 制 包括 多 个 基本 概念 : 


: DAG: 有 向 无 环 图 。 

: DODAG: 面向 节点 的 有 向 无 环 图 。 

: DIO: DAG 信 息 对 象 ，RPL 节 点 发 送 ， 用 于 传递 DODAG 及 其 特性 信息 ， 该 信息 主要 被 用 来 进行 DODAG 的 发 现 、 构 建 和 维护 。 
:DAO: 支持 点 对 点 和 点 对 多 的 方式 油 DODAG 的 上 行 方向 传递 目标 信息 ， 用 于 填充 前 驱 节点 路 由 表 。 


在 RPL 机 制 中 ， 边 界 路 由 定期 广播 DIO 请 求 ， 终 端 设备 收 到 DIO 请 求 之 后 ， 根 据 DIO 请 求 中 的 内 容 返 回 DAO 响 应 ， 边 界 路 由 收 到 DAO 响 应 之 后 便 确认 某 个 终端 节点 已 经 加 入 了 该 低 功 耗 无 线 局 域 网 。 终 
端 节点 加 入 边界 路 由 的 过 程 如 图 10-13 所 示 。 


图 10-13 ”终端 节点 加 入 网 络 过 程 简 述 


10.5 增加 NAT64 


虽然 SensorTag 已 经 加 入 了 由 树 莓 派 建立 的 低 功 耗 无 线 局 域 网 ， 但 是 sensorTag 的 联网 能 力 依然 不 完整 。 此 时 SensorTag 处 于 一 个 纯 IPv6 网 络 中 ， 也 就 是 说 sensorTag 自 身 只 有 1IPv6 地 址 ， 也 只 能 识别 


IPv6 地 址 ， 而 不 能 识别 任何 一 个 I|Pv4 地 址 。SensorTag 的 这 种 不 识别 1Pv4 地 址 的 特性 看 起 来 非常 奇怪 ， 但 是 这 种 纯 I|Pv6 网 络 确实 存在 。 只 能 说 |Pv6 比 IPv4 简 单 ， 而 SensorTag 只 能 识别 更 简单 的 协议 。 如 果 
与 树 莓 派 相 连 的 路 由 器 已 经 具备 1Pv6 功 能 ， 并 且 电 信 级 别 运营 商 也 提供 |Pv6 功 能 的 话 ， 那 么 SensorTag 便 可 很 轻松 地 访问 任意 一 台 具 备 1Pv6 地 址 的 主机 。 但 是 往往 事与愿违 ，1Pv4 主 机 的 数量 现 阶段 仍 远 大 
于 IPv6 主 机 。 那 么 SensorTag 也 就 只 能 借助 于 NAT64 这 样 的 转换 技术 才 可 以 间接 地 访问 IPv4 主 机 。 


10.5.1 NAT64 简 介 


NAT64 是 众多 IPv6 过 渡 技 术 的 一 种 ， 而 Jool 是 Linux 平 台 下 NAT64 的 具体 实现 ， 此 处 通过 一 个 具体 的 例子 说 明 NAT64 的 基本 原理 。 此 时 SensorTag 的 IPv6 地 址 为 fd00: : 212: 4b00: 42a: 
eaf0，Jool ( 见 10.5.2 节 ) 部 署 于 树 莓 派 中 ， 而 树 莓 派 的 IPv4 地 址 为 192.168.0.6，SensorTag 需 要 访问 一 台 IPv4 主 机 ，IPv4 主 机 的 地 址 为 192.168.0.3， 此 时 1IPv4 主 机 在 5678 端 口 开 启 一 个 UDP ECHO 服 务 。 
SensorTag 访 问 192.168.0.3 主 机 的 具体 过 程 如 图 10-14 所 示 。 


1) SensorTag 访 问 IPv4 主 机 ， 该 主机 的 IPv4 地 址 为 192.168.0.3， 由 于 SensorTag 无 法 识别 IPv4 地 址 ， 所 以 采用 一 种 IPv6-IPv4 兼 容 地 址 ，1Pv4 地 址 占 IPv6 地 址 的 最 后 4 字 节 ， 在 这 4 字 节 之 前 增加 一 个 固 
定 2 字 节 前 缀 0xffff， 其 他 部 分 全 部 使 用 0 填充 ， 那 么 192.168.0.3 的 1Pv6 兼 容 地 址 为 : : ffff: 192.168.0.3, 或 可 表示 为 : : ffff: c0a8: 3, 


2) SensorTag 构 造 一 个 请 求 ， 在 该 请 求 中 IPv6 源 地 址 为 fd00: : 212: 4b00: 42a: eaf0， 源 端口 号 为 8765; IPv6 目 标 地 址 为 : : ffff: 192.168.0.3， 目 标 端口 号 为 5678。 


3) 边界 路 由 收 到 该 请 求 后 发 现 该 请 求 的 目标 地 址 为 一 个 |Pv6-1Pv4 兼 容 地 址 ， 所 以 把 ffff 前 缀 去 除 ， 恢 复 为 192.168.0.6; 并 把 该 源 地 址 和 源 端 口号 修改 为 192.168.0.6 和 62846， 此 时 Jool 会 保存 一 张 端 
口号 和 IPv6 主 机 的 对 应 表 ， 此 时 62848 代 表 fd00: : 212: 4b00: 42a: eaf0 主 机 中 8765 端 口 的 具体 应 用 。 


4) 192.168.0.3 主 机 收 到 了 位 于 ?678 端 口 的 请 求 ， 但 是 这 人 台 主 机 认为 该 请 求 由 192.168.0.6 主 机 发 来 而 不 是 SensorTag。192.168.0.3 主 机 根据 请 求 内 容 返 回响 应 ， 并 把 响应 内 容 返 回 至 192.168.0.6 主 机 
(NAT64 网 关 ) 。 


5) 192.168.0.6 主 机 (NAT64 网 关 ) 收 到 了 响应 内 容 ， 该 主机 发 现 响应 目标 端口 号 为 62846， 在 端口 号 与 1Pv6 主 机 对 应 表 中 该 响应 需 转发 至 SensorTag， 所 以 该 主机 再 次 修改 目标 IP 地 址 和 目标 端口 
号 ,把 IPv4 地 址 转换 为 IPv6-1Pv4 兼 容 地 址 。 


NAT64 机 制 其 实 与 1Pv4 中 常用 的 NAT 机 制 非常 相似 ， 通 过 NAT64 机 制 可 帮助 纯 |Pv6 设 备 访问 IPv4 应 用 ， 如 图 10-14 所 示 。 


fd00::212:4b00:42a:eaf0 192.168.0.6 192.168.0.3 
EM. 
SensorTag 
CC2650 190 — 
WEHE — |^ $390:212:4b00:42a:eaf0 192.168.0.6 : 
源 端口 “， 8765 62846 
目标 地 址 ， [ES 192.168.0.3 
zs d | pool6 = ::ffff:0:0/96 
目标 闹 口 : 15678 5678 
源 地 址 — s f60f:192.168.0.6 192.168.0.3 ! 
WmH  ; 5678 5678 : 
目标 地 址 fd00::212:4b00:42a:eaf0 192.168.0.6 : 
目标 端口 ， 国医 62846 


图 10-14 NAT64 机 制 简 


> 


10.5.2 ”安装 Joo| 


了 解 NAT64 的 原理 之 后 ， 我 们 可 在 树 莓 派 上 安装 NAT64 的 具体 实现 一 一 Jool。Joo|l 是 Linux 平 台 下 NAT64 的 具体 实现 ，Joo| 的 更 多 介绍 请 参考 以 下 网 址 : 
http://www.jool.mx/en/index.html 
1. 安 装 树 莓 派 内 核 头 文件 


下 面 介 绍 如 何在 树 莓 派 中 安装 Jool，Jool 在 Linux 内 核 中 实现 NAT64， 兰 在 树 莓 派 中 编译 Jool 需 要 先 安装 树 莓 派 内 核 头 文件 ， 在 树 莓 派 控 制 人 台中 输入 以 下 内 容 : 


# 更 新 软件 源 

sudo apt-get update 
# 安装 树 侮 派 内 核 头 文件 
sudo apt-get install raspberrypi-kernel-headers 


2. 编 译 并 安装 Jool 


在 树 莓 派 中 新 建 一 个 名 为 software 的 文件 夹 ， 在 该 文件 夹 中 下 载 最 新 版 本 的 Joo| 源 代码 ， 然 后 使 用 make 命 令 编译 源 代 码 ， 最 后 通过 sudo make install 命 令 安装 Jool， 具 体操 作 如 下 : 


# 新 建 software 文 件 夹 
mkdir -p software 
cd software 
# 下 载 3.5.1 版 本 Jool 源 代码 ， 并 解压 至 software 目 录 
wget https://www.jool.mx/download/Jool-3.5.1.zip 
unzip Jool-3.5.1.zip 

# 进入 mod 子 目录 

cd Jool-3.5.1/mod 

# 编译 Jool 源 代码 

make 
# 安装 Jool 
sudo make install 


3. 加 入 开机 启动 项 


为 了 更 方便 地 启用 NAT64， 可 在 开机 启动 项 目 中 加 载 Jool， 与 Native-Border-Router 功 能 相似 ， 可 在 /etc/rc.local 文 件 中 增加 载 入 Jool 所 需 的 指令 。 


sudo nano /etc/rc.local 


在 /etc/rc.local 文 件 中 增加 modprobe jool pool6- : : ffff: 0: 0/96， 此 时 Jool| 将 把 以 : : ffff: 0: 0/96 开 头 的 IPv6 地 址 转化 为 IPv4 地 址 。 最 终 /etc/rc.local 文 件 将 包含 以 下 内 容 : 


# 增加 NAT64 功 能 

modprobe jool pool6=: :ffff:0:0/96 

# 执行 hative-border-router 

cd /home/pi/repo/contiki/examples/ipv6/native-border-router 
./border-router.native -s /dev/ttyUSBO fd00::1/64 & 


exit 0 


重新 启动 树 长 派 完成 Jool 安 装 操作 ， 为 了 验证 SensorTag 是 否 可 以 正常 访问 IPv4， 我 们 通过 一 个 UDP NAT64 示 例 验证 Joo| 是 否 工作 正常 。 


10.5.3 UDP NAT64 示 例 


下 面 我 们 通过 一 个 UDP 示 例 验 证 边界 路 由 和 NAT64 是 否 工 作 正 常 ， 在 这 个 示例 中 ，Sensor Tag 将 试图 访问 一 个 位 于 IPv4 地 址 为 192.168.0.3 的 主机 中 的 IPv4 应 用 ， 该 IPv4 应 用 为 一 个 UDP Echo 
Server， 在 第 3 章 已 经 使 用 Python 3 编写 了 一 个 UDP Echo Server， 此 处 我 们 继续 使 用 该 UDP Server, 


SensorTag UDP client 示例: 


the beginning of coap \microsystem device\examples\sensortag\nat-udp-client 


UDP Echo Server 示 例 : 


the beginning of coap\review demo\udp echo demo 


由 于 SensorTag 的 目标 UDP 端口 号 为 5678， 需 要 修改 udp-server.py 中 的 UDP 服务 端口 号 为 5678。 
1. 示 例 简 述 


本 节 的 示例 与 本 章 的 最 终 示例 非常 相似 ， 该 示例 是 CoAP 客 户 端 示例 的 基础 。 该 示例 中 SensorTag 的 IPv6 全 局 地 址 为 fd00: : 212: 4b00: 42a: eaf0，SensorTag 将 试图 访问 一 个 UDP 服务 ， 该 服务 位 
于 IPv4 地 址 为 192.168.0.3 的 主机 中 ， 该 主机 中 包含 一 个 UDP Echo 服务 ， 该 Echo 服务 部 署 于 5678 端 口 。 若 按 下 SensorTag 的 左 侧 按键 ， 那 么 SensorTag 将 向 Echo 服务 器 发 起 UDP 请 求 ， 这 个 “不 同 寻 
常 ” 的 UDP 请 求 将 由 无 线 数据 变 为 有 线 数据 ， 将 由 被 6LoWPAN 压 缩 的 IPv6 数 据 包 变 为 常见 的 IPv4 数 据 包 ， 经 过 一 系列 的 变化 之 后 这 个 “不 同 寻常 ”的 UDP 请 求 变 为 一 个 再 普通 不 过 的 1Pv4 UDP 请 求 。 对 于 
192.168.0.3 主 机 而 言 ，SensorTag 与 局 域 网 中 其 他 主机 完全 相同 ， 而 对 于 SensorTag 而 言 ， 它 借助 IEEE 802.15.4 和 6LoWPAN 压 缩 技术 “无 颖 ”地 接 入 了 传统 网 络 。 图 10-15 的 加 粗 虚 线 说 明了 数据 转移 的 
大 致 过 程 。 


fd00::212:4b00:42a:eaf0 UDP Client 192.168.0.3 UDP Server 


SensorTag “下载 天 /虚拟 串口 
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0 g NAT64 Gateway 
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Pool6 = ::FFFF:0:0/96 
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图 10-15 UDP NAT64 示 例 网 路 结构 图 
2.udp-client.c 部 分 代码 
udp-client.c 实 现 了 UDP Client 功 能 ， 具体 代码 如 下 : 


代码 清单 10-3 udp-dlient.c 


#include "contiki.h" 

#include <stdio.h> 

#include "net/ip/uip.h" 

#include "net/ipv6/uip-ds6.nh" 
finclude "net/ip/uip-udp-packet.h" 


dinclude "dev/leds.h" 
#include "dev/button-sensor.h" 


#include "ip64-addr.h" 


#include <stdio.h> 
#include <string.h> 


#define UDP CLIENT PORT 8765 
#define UDP SERVER PORT 5678 


#define DEBUG DEBUG PRINT 
#include "net/ip/uip-debug.h" 


#define MAX PAYLOAD LEN 32 


static struct uip udp conn *client conn; 
static uip ipaddr t server ipaddr; 


PROCESS (udp client process, "UDP client process"); 
PROCESS (hello world process, "hello world process"); 
AUTOSTART PROCESSES (&hello world process); 


PROCESS THREAD (hello world process, ev, data) 


static struct etimer et reg; 
PROCESS BEGIN(); 


etimer set(&et red, CLOCK SECOND / 8); 
printf ("hello world! Nn"); 


PROCESS YIELD(); 


if (eV == PROCESS EVENT TIMER && etimer expired(&et red)) ( 
if(uip ds6 get global(ADDR PREFERRED) != NULL) { 
leds off (LEDS RED); 
printf ("device has joined the net"); 
process start(&udp client process, NULL); 

) else ( 
leds toggle (LEDS RED); 
etimer set(&et red, CLOCK SECOND / 8); 


} 
} 


ky 


PROC 


ESS 


END() ; 


} 


static void 
tcpip handle 
il 


char *st 
i 


S 
S 


Cr 


f(uip newdata ()) 


tr[uip datalen()] 


r (void) 


r; 
{ 
uip appdata; 


prin 
} 


static void 


tf ("da 


send packet (void) 


{ 


static int seq id; 


= IN 


ta recv '$s ']\n", str); 


LE 
r 


0 
] 


char buf[MAX PAYLOAD LEN]; 
seq idt*; 
PRINTF ("data send to $02X 'Hello $d'Wn", 
server ipaddr.u8 [sizeof (server ipaddr.u8) - 1], seq i3); 
sprintf (buf, "Hello $d Mn", seq id); 
uip udp packet sendto(client conn, buf, strlen(buf), 


PROCI 


&server ipaddr, U 


PROCESS BEGIN(); 
printf(" 
uip ip4addr t ip4addr; 


IP HTONS(UDP SERVER PORT)); 


ESS THREAD(udp client process, ev, data) 


udp client process started"); 


uip ipaddr(&ip4addr, 192, 168, 0, 3); 


ip64 addr 4to6(&ip4addr, &server ipaddr); 


lien 
f (clien 
PRIN 


c 
i 


t conn == NULL) 
TF("No UDP conn 


PROC 


ESS EXITO ; 


} 
udp bind 


INT6AD 
INTF(" 
IP 

rint 


N N N 


Ci fU 'u rg 


p EC 


(client conn, U 


DR(&client conn 


t conn = udp new (NULL 
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ERV 


IP HIONS (UDP S ER PORT), NULL); 


{ 


eci 


IP HTONS (UDP CL 


, 


tion available, exiting the process!Wn"); 


ENT PORT)); 


INTF("Created a connection with the server "); 
-»ripaddr); 


local/remote port $u/£$uMn", 


HTONS (client conn-»lport), U 


IP HTONS (client conn-»rport)); 


Press le 


while (1) 


{ 


PROC 


ESS Y 


ELD(); 


l 


} 
1 


} 


tcpip handler (); 


send packet () ; 


PROC 


ESS | 


END (); 


udp-client.c 的 具体 解释 如 下 。 


f(ev == tcpip event) 


f (ev == sensors event && data == &button sensor) 


Ft button to send udp packet"); 


{ 


{ 


(1) 加 入 网 络 后 启动 udp_client_process 


udp_client_process 并 不 能 上 电 之 后 立即 


has joined the net" , 


H- 


f (uip ds6 g 
leds off 


et global( 
(LEDS RED); 


printf 


process_start (& 


(2) T43&lIPvA-IPv63E tbi 


ADDR PI 


\ 一 /一 


运行 ， 该 任务 需要 在 SensorTag 加 入 网 络 之 后 才 被 启用 。 加 入 网 络 之 前 红色 LED 不 停 闪 烁 ， 一 旦 加 入 网 络 成 功 红色 LED 熄 火 ， 并 通过 串口 控制 台 输 出 “device 


R 


EF 


ERR 


ED) != NULL) { 


("device has joined the netn"); 
udp client process, NULL); 


在 Contiki 中 可 使 用 ip64_addr 4to6 构 造 一 个 I|Pv4-1Pv6 兼 容 地 址 ， 此 时 server_ipaddr 指 向 IPv4 地 址 为 192.168.0.3 的 主机 。 


uip ip4addr 


t ip4addr; 


uip ipaddr(&ip4addr, 192, 168, 0, 3); 


ip64 addr 4to6(&ip4addr, &server ipaddr); 


(3) 构造 UDP 套 接 字 


client conn 
udp bind(cli 


ent conn, U 


(4) 发 送 UDP 请 求 


udp new(NULL, UIP HTONS (UDP S 
IP HTONS (UDP CL 


udp_new 和 udp_bind 构 造 一 个 UDP 客户 端 套 接 字 。 


' SERVER. PORT), NULL); 
ENT PORT)); 


一 旦 按 下 SensorTag 左 侧 按键 ，Contiki 中 的 传感器 驱动 便 向 udp_client_process 任 务 发 送 一 个 事件 ， 该 事件 的 具体 值 为 button_sensor。udp _client_process 接 收 到 该 事件 之 后 便 会 执行 UDP 请 求 。 


f(ev 
send pac 


ket(); 


(5) 处 理 UDP 响 应 


sensors event && data 


{ 


&button sensor) 


SensorTag 一 旦 收 到 UDP 响应 ，Contiki 中 的 网 络 驱动 便 向 udp_client_process 任 务 传递 一 个 tcpip_event 事 件 。 


f (ev == tcp 
tcpip ha 


{ 


ip event) 
ndler(); 


fttcpip handleregZirB, SensorTag/Auip appdata 中 可 读 取 UDP 响应 内 容 ， 而 uip_datalen 可 指示 UDP 响应 内 容 长 度 。SensorTag 把 响应 内 容 输出 到 串口 控制 台中。 


static void 
tcpip handler (void) 
{ 


char *str; 

if(uip newdata()) { 

str — uip appdata; 

str[uip datalen()] = 'N0'; 

printf ("data recv '$s ']Mn", str); 


3. 测 试 并 验证 
下 面 我 们 来 测试 这 个 不 同 寻常 的 UDP Echo 示例 。 


(1) 生成 并 下 载 udp-client.hex 


# 生成 hex 固 件 
cd ~/resp/the beginning of coap/microsystem device/examples/sensortag/nat-udp-client 
make BOARD-sensortag/cc2650 


通过 make 命 令 生成 udp-client.hex 文 件 ， 并 使 用 Flash Programmer2 下 载 软件 把 固件 下 载 至 SensorTag 中 。 
(2) 在 192.168.0.3 主 机 中 运行 udp-server.py 


修改 UDP 侦 听 端口 号 为 5678， 在 192.168.0.3 主 机 中 运行 udp_server.py ( 见 3.3.1 节 ) 。 


# 在 192.168.0.3 主 机 中 运行 udp_server.Py 
Python3 udp server.py 


(3) 等 待 SensorTag 加 入 网 络 


SensorTag 重 新 上 电 运 行 之 后 将 加 入 由 树 莓 派 内 边界 路 由 组 成 的 低 功 耗 网 络 ， 该 网 络 的 全 局 前 缀 为 fd00: : 1/64。 若 SensorTag 未 加 入 该 网 络 ， 红 色 LED 将 持续 闪烁 ， 一 旦 加 入 网 络 成 功 ， 红 色 LED 将 
停止 内 烁 ， 绿 色 LED 将 处 于 常 亮 状态 。 在 串口 控制 台 将 获得 以 下 输出 : 


Starting Contiki-3.x-2906-g14bfa 
With DriverLib v0.46593 

TI CC2650 SensorTag 

Net: sicslowpan 

MAC: CSMA 

RDC: ContikiMAC, Channel Check Interval: 16 ticks 

RF: Channel 25 

Node ID: 19203 

hello world! 

device has joined the net 

udp client process started 

Client IPv6 Address: fd00::212:4000:7c9:4b03 
fe80::212:45b00:7c9:4503 

Server address: ::FPFF:192.168.0.3 

Created a connection with the server :: local/remote port 8765/5678 
Press left button to send udp packet 


串口 输出 的 最 后 提示 用 户 按 下 SensorTag 的 左 侧 按键 ， 一 旦 按 下 左 侧 按键 SensorTag 将 会 启动 一 次 UDP 请 求 。 
(4) 按 下 sensorTag 左 侧 按键 


按 下 左 侧 按键 之 后 ，SensorTag 将 会 发 送 一 次 UDP 请 求 ，SensorTag 一 旦 收 到 服务 器 响应 内 容 ， 它 将 把 响应 内 容 输出 至 串口 控制 台 。UDP 请 求 中 包含 一 个 序号 ， 每 按 下 一 次 左 侧 按 键 , 该 序号 值 将 递增 
一 次 ， 如 第 一 次 按 下 时 UDP 请 求 内 容 为 “Hello 1”， 第 二 次 按 下 时 UDP 请 求 内 容 为 “Hello 2”。 串 口 控制 台 将 获得 以 下 类 似 内 容 : 


data send to 03 'Hello 1' 
data recv 'Hello 1' 
data send to 03 'Hello 2' 
data recv 'Hello 2' 


10.6 CoAP Client Sensor 


经 过 前 面 几 个 小 节 的 准备 工作 ， 我 们 已 经 熟悉 了 开发 Contiki 应 用 的 基本 方法 ， 另 外 树 莓 派 内 的 边界 路 由 和 NAT64 网 关 也 可 正常 工作 。 只 要 在 sensorTag 中 增加 必要 传感器 检测 功能 和 CoAP 客 户 端 功能 
便 可 组 成 一 个 完整 的 应 用 。 本 小 节 中 CoAP Client Sensor 示 例 是 一 个 较为 完整 的 示例 ， 具 体 实 现代 码 请 参考 本 书 代码 仓库 : 


the beginning of coap\microsystem device\examples\sensortag\coap-client-sensor 
CoAP Client Sensor 示 例 由 三 个 C 文 件 组 成 : 
coapb-client-sensof'c 包 含 一 个 启动 任务 ，SensofTag 加 入 网 络 之 后 立刻 启动 相应 的 传感器 检测 任务 和 CoAP 客 户 端 推送 任务 。 
:Sehsot-pbtocess.c 包 含 一 个 传感器 检测 任务 ， 该 任务 定期 获取 温度 、 湿 度 和 光照 传感器 检测 结果 。 一 旦 检测 完成 ， 将 通过 Contiki 的 消息 载体 传递 至 coap-postptocess 任 务 。 


:coap-post-ptocess.c 包 含 一 个 CoAP 客 户 端 任务 ， 该 任务 把 从 传感器 任务 获取 的 最 新 数据 封装 为 JSJON 格 式 ， 并 向 指定 服务 器 发 送 CoAP 请 求 。 


10.6.1 ”加 入 网 络 并 启动 任务 


coap-client-sensor.c 中 仪 包括 start_ processtE2s, 一旦 SensorTag 加 入 网 络 便 启 动 sensor_process 和 coap_post_process 两 个 任务 。 


代码 清单 10-4 coap-client-sensor.c 


dinclude <stdio.h> 
dinclude <stdlib.h> 


#include <string.h> 
#include "contiki.h" 
#include "contiki-net.h" 
#include "dev/leds.nh" 
#include "board-peripherals.h" 
#include "sensor-process.h" 
#include "coap-post-process.h" 
#define DEBUG DEBUG PRINT 
#include "net/ip/uip-debug.h" 
PROCESS (start process, "start process"); 
AUTOSTART PROCESSES (&start process); 
PROCESS THREAD(start process, ev, data) 
{ 
static struct etimer et red; 
PROCESS BEGIN(); i 
etimer set(&et red, CLOCK SECOND / 8); 
printf ("system start!WMn"); 
while(1) ( 
PROCESS YIELD(); 
if (eV == PROCESS EVENT TIMER && etimer expired(&et red)) ( 
if(uip ds6 get global (ADDR PREFERRED) != NULL) { 
leds off(LEDS RED); 
printf ("device has joined the net\n"); 
process start(&sensor process, NULL); 
process start(&coap post process, NULL); 
) else { 
leds toggle (LEDS RED); 
etimer set(&et red, CLOCK SECOND / 8); 
) 
) 
} 
PROCESS END(); 


10.6.2. ”获取 传感器 数据 


sensor_process 主 要 用 于 获取 传感器 检测 结果 ， 与 SensorTag 相 关 的 温 湿 度 传感器 和 光照 传感器 
8HDC1000 和 光照 传感器 


J 效率 。 


"m, 


温 湿度 传感器 
待 时 间 ， 提 高 执 和 


经 包含 在 Contiki 传 感 器 驱动 中 ， 只 需 调 用 相应 的 接口 便 可 以 获取 检测 结果 。 在 Contiki 传 感 器 驱动 


8OPT3001 被 设计 为 “异步 ”传感器 。 一 旦 完成 传感器 检测 动作 ， 传 感 器 驱动 将 向 相关 任务 发 送 一 个 完成 事件 。 昌 然 这 样 的 方式 显得 有 些 麻烦 ， 但 可 以 减少 MCU 等 


代码 清单 10-5 sensor process.c 
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uc 


L e 


tic void ge 


int value; 
value 
Lf 


printi 
} 


value 


(value != CC26XX S] 
sensor give.temp = value / 100; 
F("HDC: Temp = 


timer et; 


hdc 1000 sensor.val 
ENSOR R 


lude "sensor-process.h" 
lude "coap-post-process.h" 


t/ip/uip-debug.h" 


t sensor data ready; 
t sensor give; 
t hdc reading () 


I 


" 


ENSOR TYPE ' 
{ 


ue (HDC 1000 Si 
EADING ERROR) 


EMP) ; 


hdc 1000 sensor.val 


[o 


g 


[*] 


$d.502d C\n", value / 100, value $ 100); 


ue (HDC 1000 SI 


E 


P. 


HUM 


ENSOR TYP TY)? 


if (value != CC26XX SENSOR READING ERROR) { 
sensor give.hum = value / 100; 
printf ("HDC: Humidity = %d.%02d %%RH\n", value / 100, value $ 100); 
} 
static void get light reading () 
int value; 
value = opt 3001 sensor.value (0); 
if (value != CC26XX SENSOR READING ERROR) { 
sensor give.light = value / 100; 
printf("OPT: Light = $d.£02d lux\n", value / 100, value $ 100); 
} 
ROCESS (sensor process, “sensor monitoring"); 
ROCESS THREAD (sensor process, ev, data) 
PROCESS BEGIN(); 
printf ("sensor process start! Mn"); 
sensor data ready - process alloc event(); 
etimer set(&et, CLOCK SECOND * 60); 


while(1) { 
PROCESS YIELD(); 
if (ev == PROCESS EVENT TIMER && data == &et) { 
printf ("start to acquire sensor dataWM"); 
SENSORS ACTIVATE (opt 3001 sensor); 
etimer set(&et, CLOCK SECOND * 60); 
) else if(ev == sensors event && data == &opt 3001 sensor) { 
get light reading (); 
SENSORS ACTIVATE (hdc 1000 sensor); 
) else if(ev == sensors event && data == &hdc 1000 sensor) { 
get hdc reading(); 
process post(&coap post process, sensor data ready, (void *)&sensor give); 
J 
} 
PROCESS END(); 


sensor_process.c 的 具体 说 明 如 下 。 


sensor_process 通 过 一 个 etimer 定 时 器 间隔 60s 获 取 一 次 


PROCI 


{ 


(1) 间隔 60 s 获 取 一 次 


ESS THRE 


SE 


etimer set(&et, CLOCK Sl 


while (1) 


{ 


PROC 


ESS Y 


ELD(); 


传感器 


[EB 


器 结果 


SE 


传感器 检测 结果 。 一 旦 60s 定 时 时 间 到 ， 则 先 开 启 光照 传感器 SENSORS_ACTIVATE (opt 3001 sensor) 。 


AD (sensor process, ev, data) 


ECOND * 60); 


if (ev == PROCESS EVENT TIMER && data == &et) { 
printf ("start to acquire sensor dataWM"); 

SENSORS ACTIVATE (opt 3001 sensor); 

etimer set(&et, CLOCK SECOND * 60); 


) 
// 省 略 部 分 代码 
} 


PROCESS END(); 


(2) 光照 传感器 检测 完成 之 后 再 局 动 温 湿 度 传 感 器 


和 光照 传 感 器 检测 完成 ，Contiki 传 感 器 驱动 将 向 任务 传递 一 个 sensors_event 事 件 ， 该 事件 的 值 为 opt_3001_sensor。 通 过 get light_reading 函 数 获 取 光 照 传 感 器 结果 之 后 ， 再 通过 
SENSORS ACTIVATE (hdc 1000 sensor) 启动 温 湿度 传感器 转换 。 一 旦 温 湿度 传感器 检测 完成 ，Contiki 传 感 器 驱动 将 会 向 任务 传递 一 个 sensors_event 事 件 ， 该 事件 的 值 为 hdc_1000_sensor。 


while(1) { 
PROCESS YIELD(); 
if(ev == PROCESS EVENT TIMER && data == &et) { 
SENSORS ACTIVATE (opt 3001 sensor); 

) else if(ev == sensors event && data == &opt 3001 sensor) { 
get light reading(); 
SENSORS ACTIVATE (hdc 1000 sensor); 

) else if(ev == sensors event && data == &hdc 1000 sensor) { 
get hdc reading(); 
process post(&coap post process, sensor data ready, (void *)&sensor give); 


(3) [Blcoap post process 任 务 传递 检测 结果 


通过 process_post 函 数 向 coap_post_process 任 务 传递 转换 结果 。process_post 用 于 Contiki 内 不 同 任务 间 传 递 事件 和 事件 结果 ， 若 温 湿 度 传感器 和 光照 传感器 都 完成 检测 ， 那 么 通过 
sensor data_ready 事 件 把 传感器 检测 结果 传递 至 coap_post_process 任 务 中 。 


process post(&coap post process, sensor data ready, (void *)&sensor give); 


10.6.3 ”传单 传感器 数据 
coap_post_process.c 主 要 负责 把 传感器 检测 结果 通过 CoAP 推 送 至 服务 器 。 
代码 清单 10-6 coap post process.c 


#include "coap-post-process.h" 
#include "sensor-process.h" 


#define DEBUG DEBUG PRINT 
#include "net/ip/uip-debug.h" 


#define LOCAL PORT UIP_HTONS (COAP DEFAULT PORT + 1) 
#define REMOTE PORT UIP HTONS (COAP DEFAULT PORT) 


uip ipaddr t server ipaddr; 


void 
client chunk handler (void *response) 
{ 
const uint8 t *chunk; 
int len = coap get payload (response, &chunk); 


printf ("coap response payload:\n"); 
printf("[$d]$sWMn", len, (char *)chunk); 


ROCESS (coap post process, "coap client"); 
ROCESS THREAD(coap post process, ev, data) 


PROCESS BEGIN(); 
printf ("coap post process start!WMn"); 


static coap packet t request[1]; 


uip ip4addr t ip4addr; 
uip ipaddr(&ip4addr, 192, 168, 0, 3); 
ip64 addr 4to6(&ip4addr, &server ipaddr); 


printf("Server address: "); 
print6addr(&server ipaddr); 
printf ("Mn"); 


uint8 t dev addr[8]; 
ieee addr cpy to(dev addr, 8); 


static char url[32]; 
sprintf (url, "devices/$02X$02X", dev addr[6], dev addr[7]); 
printf ("device url: $sWMn", url); 


/* receives all CoAP messages */ 
coap init engine(); 


while(1) { 
PROCESS YIELD(); 
if (ev == sensor data ready) { 
printf ("take sensor date ready event in"); 
sensor data t sensor take - *(sensor data t*)data; 
coap init message (request, COAP TYPE CON, COAP POST, 0); 


coap set header uri path(request, url); 
coap set header content format (request, APPLICATION JSON); 


char payload[32]; 

memset (payload, 0x00, 32); 

int len = sprintf (payload, "{\"temp\":%d, \"hum\":3d, \"light\":%d}", 
sensor take.temp, sensor take.hum, sensor take.light); 

coap set payload (request, (uint8 t *)payload, len); B 


printf ("coap request payload: $sMn", payload); 
print6addr(&server ipaddr); printf(" : $uNMn", UIP HTONS (REMOTE PORT)); 


COAP BLOCKING REQUEST (&server ipaddr, REMOTE PORT, request, 
client chunk handler); 


PROCESS END(); 


coap post process.c 的 具体 解释 如 下 。 


(1) 构造 1Pv4-1Pv6 兼 容 地 址 


在 Contiki 操 作 系 统 中 可 使 用 ip64_addr_4to6 构 造 一 个 IPv4-lPv6 兼 容 地 址 ， 此 时 server_ipaddr 指 向 IPv4 地 址 为 192.168.0.3 的 主机 ，。 


uip ip4addr t ip4addr; 
uip ipaddr(&ip4addr, 192, 168, 0, 3); 
ip64 addr 4to6(&ip4addr, &server ipaddr); 


(2) 获取 网 卡 地 址 并 构造 URL 


在 微型 物 联网 系统 服务 器 部 分 已 经 定义 ， 设 备 的 编号 由 4 个 数字 组 成 ， 为 了 尽 可 能 保证 每 个 设备 编号 不 相同 ， 此 处 使 用 SensorTag/CC2650 的 MAC 地 址 的 最 后 两 字 节 作为 设备 编号 ， 使 用 
ieee_addr_cpy_to 冰 数 可 获取 CC2650 的 MAC 地 址 。 


uint8 t dev addr[8]; 

ieee addr cpy to(dev addr, 8); 

static char url[32]; 

sprintf (url, "devices/$02X$02X", dev addr[6], dev addr[7]); 


(3) 构造 CoAP 请 求 首部 


通过 coap_init _ message 函数 设置 CoAP 首 部 中 报 文 类 型 和 CoAP 方 法 ， 根 据 微 型 物 联网 系统 服务 器 部 分 的 设计 ，CoAP 请 求 类 型 为 CON ，CoAP 请 求 方法 为 POST; 此 处 还 通过 
coap set header_uri_path 函 数 定 义 CoAP 首 部 中 的 URL， 通 过 coap set header content format 定 义 CoAP 请 求 媒体 类 型 为 JSON 类 型 。 
coap init message (request, COAP TYPE CON, COAP POST, 0); 


coap set header uri path(request, url); 
coap set header content format(request, APPLICATION JSON); 


(4) 构造 CoAP 请 求 负载 
通过 sprintf 函 数 构造 JSON 格 式 的 负载 ， 并 通过 coap_set_payload 设 置 本 次 CoAP 请 求 的 具体 负载 ， 最 后 通过 COAP_BLOCKING_REQUEST 写 入 到 Contiki 网 络 层 驱动 中 。 


char payload[32]; 
memset (payload, 0x00, 32); 
int len = sprintf (payload, "{\"temp\":%d, V'humNV":$d, \"light\":%d}", 
sensor take.temp, sensor take.hum, sensor take.light); 
coap set payload (request, (uint8 t *)payload, len); 
COAP BLOCKING REQUEST (&server ipaddr, REMOTE PORT, request, 
client chunk handler); 


10.7. RAMA, 


最 后 我 们 进行 一 个 较为 综合 的 测试 验证 终端 节点 是 否 正常 工作 ， 本 章 示 例 或 许 是 本 书 中 最 为 复杂 的 示例 ， 该 示例 涉及 Contiki 系 统 的 基本 使 用 方法 、 边 界 路 由 的 创建 、NAT64 实 现 等 部 分 。 综 合 测试 可 分 
为 三 步 实现 : 


1) 在 192.168.0.3 主 机 中 运行 “node app.js”， 启 用 CoAP 服 务 器 和 和 Web 服务 器 。 
2) 在 树 葡 派 中 启动 边界 路 由 和 NAT64。 
3) 在 SensorTag 中 下 载 coap-client-sensor.hex 固 件 。 


综合 测试 的 具体 流程 如 图 10-16 所 示 。 


1) node app.]S 


3) coap-client-sensor.hex 


AA EM 
192.168.0.1 


SN 


192.168.0.3 


i fd00::212:4b00:7c9:4b03 
纯 IPv4 网 络 


^ 纯 IPv6 网 络 

y 

CC2538  |Slip-Radio 树 莓 派 3 代 — 192.168.0.6 
NAT64 Gateway 


native-border- oo] 
router joo 2) /etc/rc.local 
Pool6 = ::FFFF:0:0/96 


真实 网 卡 


USB 转 串口 
Slip 


虚拟 网 卡 


图 10-16 ”综合 测试 具体 流程 


10.7.1 ”启动 CoAP 服 务 器 
在 第 9 章 已 经 完成 服务 器 的 开发 工作 ， 为 了 完成 此 处 的 综合 测试 ， 需 要 保证 192.168.0.3 主 机 中 已 经 正确 安装 了 MySQL 数 据 库 和 Node.js。 该 部 分 的 详细 实现 代码 可 参考 本 书 代 码 仓库 : 


the beginning of coap\microsystem servernode\app.js 


在 测试 服务 器 主机 (192.168.0.3) 内 启用 CoAP 服 务 器 和 和 Web 服务器， 在 控制 台中 输入 以 下 内 容 : 


node app.js 
10.7.2 ”局 动 边界 路 由 和 NAT64 
在 树 莓 派 中 正确 启用 边界 路 由 和 NAT64 功 能 。 在 树 莓 派 /etc/rc.local 文 件 中 需要 包含 以 下 类 似 内 容 : 


# 增加 NAT64 功 能 
modprobe jool poo16=: :ffff:0:0/96 

* 执行 hative-border-router 

cd /home/pi/repo/contiki/examples/ipv6/native-border-router 
ter.native -s /dev/ttyUSBO fd00::1/64 & 


./border-roul 


exit 0 


10.7.3 ”生成 并 下 载 固件 


把 coap-client-sensor.hex 固 件 下 载 至 SensorTag 中 。 


# 进入 指定 目录 

cd 

-/resp/the beginning of coap/microsystem device/examples/sensortag/coap-client-sensor 
# 生成 固件 ， 并 把 固件 下 载 至 SensorTag 中 

make BOARD-sensortag/cc2650 


10.744 ”查看 运行 结果 


当 SensorTag 正 常 运 行 之 后 ， 我 们 再 通过 串口 控制 台 、Node.js 控 制 台 和 网 页 等 手段 查看 系统 是 否 正常 运行 。 
1.SensorTag 串 口 控制 人 台 输 出 


在 SensorTag 串 口 控制 台中 我 们 可 以 观察 到 以 下 类 似 输出 : 


TI CC2650 SensorTag 

Net: sicslowpan 

MAC: CSMA 

RDC: ContikiMAC, Channel Check Interval: 16 ticks 
RF: Channel 25 

Link layer addr: 02:12:40:00:07:c9:40:03 

Node ID: 19203 

system start! 

device has joined the net 

sensor process start! 
coap post process start! 

Server address: ::FFFF:192.168.0.3 

device url: devices/4B03 

start to acquire sensor data 

OPT: Light = 67.19 lux 

HDC: Temp = 26.38 C 

HDC: Humidity = 52.36 $RH 

take sensor date ready event 

coap request payload: ("temp":26, "hum":52, "light":67) 
::FEBRE:192.168.0.3 : 5683 

coap response payload: 

[17] ("ts" :1478355804] 

start to acquire sensor data 

OPT: Light = 68.48 lux 

HDC: Temp = 26.30 C 
HDC: Humidity = 52.14 $RH 

take sensor date ready event 

coap request payload: ("temp":26, "hum":52, "light":68] 
::FEBRE:192.168.0.3 : 50683 

coap response payload: 

[17] ("ts":1478355864] 


此 时 SensorTag 完 成 了 以 下 内 容 : 
1) device has joined the net: SensorTag 成 功 加 入 网 络 ， 此 时 红色 LED 停 止 内 烁 。 
2) device url: devices/4B03: SensorTag 对 应 的 设备 编号 为 4803， 此 时 SensorTag 应 向 coap: /192.168.0.3/devices/4B03 推 送 传感器 检测 结果 。 


3) SensorTag 完 成 了 两 次 传感器 数据 采集 ， 并 把 检测 结果 封装 为 JSON 格 式 。 由 于 间隔 的 时 间 较 短 ， 所 以 两 次 的 温 湿度 和 光照 检测 结果 几乎 相同 ， 温 度 检测 结果 为 26， 湿 度 检测 结果 为 52， 光 照 检 测 结 
果 为 68。 


4) SensorTag 向 : : FFFF: 192.168.0.3 主 机 发 送 CoAP 请 求 ， 此 时 : : FFFF: 192.168.0.3 为 一 个 |Pv4-1IPv6 兼 容 地 址 ， 实 际 指向 |Pv4 地 址 为 192.168.0.3 的 主机 . 
2.Nodejjs 控 制 台 输出 


在 Node.js 控 制 台 中 也 可 以 观察 到 传感器 推送 数据 ， 此 时 CoAP 服 务 器 接收 到 两 次 CoAP 请 求 ， 通 过 与 串口 控制 台 的 输出 结果 比较 可 以 发 现 CoAP 服 务 器 收 到 了 正确 的 传感器 结果 。Node.js 控 制 台 的 输出 
结果 如 图 1 0- 1 7 所 示 。 


3. 网 页 显示 


最 后 使 用 浏览 器 查看 4B03 设 备 (SensorTag) 的 历史 结果 ， 在 浏览 器 中 输入 http://192.168.0.3: 8090， 在 左 侧 设 备 列表 中 选择 “4B03” 便 可 观察 到 该 设备 的 所 有 历史 数据 。4B03 设 备 的 所 有 历史 数据 
如 图 10-18 所 示 ，CoAP 服 务 器 将 两 次 CoAP 请 求 中 的 传感器 记录 插入 至 数据 库 中 ， 其 结果 与 SensorTag 串 口 控制 台 的 输出 内 容 相符 。 


ES CAWINDOWSYsystem32Ncmd.exe - node appjs 


图 10-17 Node.js app.js 控 制 台 输出 


时 间 

p 4 121*1 
pw e12mm 
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mu taunumo 
p '* 48 12 24 1" 


2016-11-05 22:24:23 


温度 
^ 
^ 
- 
^ 
^ 
26 
26 


2016-11-05 22:23:23 


ETS 1 到 第 7 条 记录 ,总 共 7 条 人 记录 SAET 10 a 条 记录 


图 10-18  SensorTag 4B03 设 备 历史 结果 


通过 sensorTag 串 口 控制 人 台 、Nodejs 控 制 台 和 网 页 显示 结果 ， 我 们 可 以 确认 微型 物 联网 系统 已 经 能 够 正常 运行 。 


10.8 本章 小 结 


本 章 我 们 完成 了 微型 物 联 网 系统 的 设备 部 分 ， 相 比 于 服务 器 部 分 的 开发 内 容 ， 设 备 部 分 的 开发 内 容 步 又 更 多 。 从 让 入 式 硬 件 角 度 来 说 ， 本 章 主要 在 SensotTag 中 进行 开发 ， 从 时 入 式 软件 的 角度 来 说 ， 本 
章 主 要 通过 Contiki 实 现 传感器 检测 和 CoAP 客 户 端 功能 。 在 物 联网 领域 Contiki 是 一 个 为 低 功 耗 受 限制 设备 而 设计 的 散 入 式 操作 系统 ， 该 操作 系统 包括 完整 的 6LoWPAN/IPv6 协 议 栈 ， 本 章 通过 几 个 简单 的 示例 
说 明 如 何 使 用 Contiki 操 作 系 统 。 


在 一 个 纯 IPv6 网 络 中 终端 设备 并 不 能 直接 访问 IPv4 应 用 ， 为 了 解决 这 个 了 矛盾， 本章 还 介绍 了 如 何在 树 莓 派 中 启用 NAT064 功 能 。 最 后 本 章 通过 一 个 完整 的 CoAP 客 户 端 示 例 说 明 如 何 使 用 SensotTag 向 指定 
CoAP 服 务 器 推送 传感器 检测 结果 。 由 于 篇 幅 限 制 ， 本 章 不 能 够 展示 Contiki 操 作 系 统 的 方方面面 ， 但 此 处 的 SensorTag CoAP 已 经 具有 足够 的 代表 性 。 至 此 ， 我 们 已 经 完成 了 微型 物 联 网 系统 的 所 有 开发 工作 ， 
只 要 符合 服务 器 微型 物 联 网 系统 的 CoAP 接 口 定 义 ， 任 何 真 实 或 虚拟 设备 均 可 接 入 该 系统 。 
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